Keyword research API. Keyword suggestions and our keyword planner in your own dashboard and AI.

Keyword research endpoints and MCP tools

The keywords topic gives your dashboard, script or AI assistant the data behind the Keyword tool page in MarketingTracer.

Both endpoints take site_id and q (up to 200 characters). If you leave out country and language, the API uses the country and language set on that site. The ads_competition field on keywords.ideas is the advertiser competition index from 0 to 100. It shows how many advertisers compete for the keyword in paid search rather than how hard it is to rank organically. When you have picked the keywords you want to follow, add them to position tracking with serp.keywords_add on the Rank tracker API.

A real keywords.suggest call and its answer

Every endpoint takes a POST with JSON (or a GET with the same parameters in the query string) and your API key in the Authorization header. Here is a real keywords.suggest answer for the Netherlands:

curl -X POST https://app.marketingtracer.com/rest/v1/keywords.suggest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"site_id": "65a1b2c3d4e5f60718293a4b", "q": "hardloopschoenen"}'

{
  "data": [
    {"keyword": "hardloopschoenen", "position": 1},
    {"keyword": "hardloopschoenen dames", "position": 2},
    {"keyword": "hardloopschoenen heren", "position": 3},
    {"keyword": "hardloopschoenen nike", "position": 4},
    {"keyword": "hardloopschoenen asics", "position": 5},
    …
    {"keyword": "hardloopschoenen dames asics", "position": 10}
  ],
  "meta": {
    "site_id": "65a1b2c3d4e5f60718293a4b",
    "next_cursor": null,
    "total": null,
    "country": "nl",
    "language": "nl"
  }
}

Endpoints, arguments and field descriptions

Every endpoint is a POST with a JSON body; reading endpoints also take a GET with the same arguments in the query string. Send your API key as Authorization: Bearer YOUR_API_KEY. Every answer is {"data": …, "meta": {…}}: meta.site_id always, meta.next_cursor and meta.total for a list, meta.period where the endpoint covers a period. An error is {"error": {"code", "message"}} with the HTTP status: 400 invalid_argument, unknown_argument or missing_argument; 401 not_authenticated; 403 no_access or tool_off; 404 not_found; 409 not_connected (a connection the endpoint needs, such as Google Analytics 4, is missing); 429 rate_limited; 502 google_error (Google returned an error on your own Search Console or Analytics connection) or upstream_error (another data source did not answer; try again in a minute). The machine-readable version is openapi.json.

keywords.suggest

POST /rest/v1/keywords.suggest · MCP tool get_keywords_suggest

Returns keyword suggestions for a keyword in a country and language: what people type after it, most common first (usually up to 10).

Arguments

Example request

curl -X POST https://app.marketingtracer.com/rest/v1/keywords.suggest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"site_id":"YOUR_SITE_ID","q":"hardloopschoenen"}'

Example response · Real answer for the Netherlands, 12 November 2026.

{
  "data": [
    {"keyword": "hardloopschoenen", "position": 1},
    {"keyword": "hardloopschoenen dames", "position": 2},
    {"keyword": "hardloopschoenen heren", "position": 3},
    {"keyword": "hardloopschoenen nike", "position": 4},
    {"keyword": "hardloopschoenen asics", "position": 5},
    {"keyword": "hardloopschoenen kind", "position": 6},
    {"keyword": "hardloopschoenen adidas", "position": 7},
    {"keyword": "hardloopschoenen decathlon", "position": 8},
    {"keyword": "hardloopschoenen sale", "position": 9},
    {"keyword": "hardloopschoenen dames asics", "position": 10}
  ],
  "meta": {
    "site_id": "YOUR_SITE_ID",
    "next_cursor": null,
    "total": null,
    "country": "nl",
    "language": "nl"
  }
}

Response fields · data is a list; each item has:

keywords.ideas

POST /rest/v1/keywords.ideas · MCP tool get_keywords_ideas

Returns keyword ideas from our keyword planner for a keyword: related keywords with their average monthly searches in the country, how much advertisers compete for them and the cost per click. Kept 30 days per keyword, country and language. Most searched first.

Arguments

Example request

curl -X POST https://app.marketingtracer.com/rest/v1/keywords.ideas \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"site_id":"YOUR_SITE_ID","q":"hardloopschoenen","limit":4}'

Example response · Illustrative: the shape is exact, the figures are made up.

{
  "data": [
    {
      "keyword": "hardloopschoenen",
      "search_volume": 33100,
      "ads_competition": 100,
      "cpc_eur": 0.62
    },
    {
      "keyword": "hardloopschoenen dames",
      "search_volume": 14800,
      "ads_competition": 100,
      "cpc_eur": 0.55
    },
    {
      "keyword": "hardloopschoenen heren",
      "search_volume": 9900,
      "ads_competition": 100,
      "cpc_eur": 0.58
    },
    {
      "keyword": "beste hardloopschoenen",
      "search_volume": 2900,
      "ads_competition": 74,
      "cpc_eur": 0.41
    }
  ],
  "meta": {
    "site_id": "YOUR_SITE_ID",
    "next_cursor": null,
    "total": 612,
    "country": "nl",
    "language": "nl"
  }
}

Response fields · data is a list; each item has: