Get GBP search keywords

Returns search keywords that triggered impressions for a Google Business Profile location. Data is aggregated monthly. Keywords below a minimum impression threshold set by Google are excluded. Max 18 months of historical data. Requires the Analytics add-on.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Query Parameters

accountIdstring

The Zernio SocialAccount ID for the Google Business Profile account.

startMonth?string

Start month (YYYY-MM). Defaults to 3 months ago.

Match^\d{4}-\d{2}$

endMonth?string

End month (YYYY-MM). Defaults to current month.

Match^\d{4}-\d{2}$

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.analytics.getGoogleBusinessSearchKeywords({  query: {    accountId: 'account_abc123',  },});console.log(data);

{
  "success": true,
  "accountId": "69300690f43160a0bc999e07",
  "platform": "googlebusiness",
  "monthRange": {
    "startMonth": "2026-01",
    "endMonth": "2026-03"
  },
  "keywords": [
    {
      "keyword": "restaurant near me",
      "impressions": 245
    },
    {
      "keyword": "best tapas barcelona",
      "impressions": 89
    },
    {
      "keyword": "zernio",
      "impressions": 34
    }
  ],
  "note": "Keywords below a minimum impression threshold are excluded by Google"
}

{
  "error": "Invalid startMonth format. Use YYYY-MM."
}

{
  "error": "Unauthorized"
}

{
  "error": "Analytics add-on required",
  "code": "analytics_addon_required"
}

{
  "error": "Access denied to this account"
}

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Query Parameters

accountIdstring

The Zernio SocialAccount ID for the Google Business Profile account.

startMonth?string

Start month (YYYY-MM). Defaults to 3 months ago.

Match^\d{4}-\d{2}$

endMonth?string

End month (YYYY-MM). Defaults to current month.

Match^\d{4}-\d{2}$

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.analytics.getGoogleBusinessSearchKeywords({
  query: {
    accountId: 'account_abc123',
  },
});
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.analytics.getGoogleBusinessSearchKeywords({  query: {    accountId: 'account_abc123',  },});console.log(data);

{
  "success": true,
  "accountId": "69300690f43160a0bc999e07",
  "platform": "googlebusiness",
  "monthRange": {
    "startMonth": "2026-01",
    "endMonth": "2026-03"
  },
  "keywords": [
    {
      "keyword": "restaurant near me",
      "impressions": 245
    },
    {
      "keyword": "best tapas barcelona",
      "impressions": 89
    },
    {
      "keyword": "zernio",
      "impressions": 34
    }
  ],
  "note": "Keywords below a minimum impression threshold are excluded by Google"
}

{
  "error": "Invalid startMonth format. Use YYYY-MM."
}

{
  "error": "Unauthorized"
}

{
  "error": "Analytics add-on required",
  "code": "analytics_addon_required"
}

{
  "error": "Access denied to this account"
}

Get GBP search keywords

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

403application/json

Get GBP search keywords

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

403application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json