Agentic Platform
Documentation API reference Tools Skills

Tools

Keywords Suggestions From Google Ads Planner

keywords_suggestions_google_ads_planner Keywords Google

Get keyword suggestions from Google Ads Keywords Planner.

Discover a comprehensive list of related keywords based on a seed keyword, including synonyms, variations, and related topics from Google Ads data. This tool identifies valuable keyword opportunities for your SEO strategy and includes detailed metrics for each keyword such as search volume, CPC, competition level, and search intent. This facilitates content planning, PPC campaigns, and identifying new market opportunities in your niche.

Playground

Your organization, project and token stay in this browser's local storage and are sent straight to the API — this page never sees them.

POST
item
keywords required List of keywords to get suggestions for
question required What data to get from the keywords
location_request Location to get suggestions for.
config
location_id Location ID (optional)
location_request Location request (ex: Paris, FR), will translate to location ID
country_code ISO3166 country code (ex: GB)
lang_code BCP47 language code (ex: "en", "en-GB")
device Device to use for search (optional - defaults to mobile)

Billing

Fixed cost per item requested, plus one keyword planner request covering every seed you pass, plus a model call that reviews the list. Keyword planner data is the dearest part by a wide margin.

These usage SKUs can be charged on a call, including SKUs from tools this one may call.

SKU Credits Description Used by
Tool call 1 per request Charged once per successful item, on top of any usage below.
  • This tool
GPT-4o (standard), input 2,500 per million tokens Tokens the model reads from the prompt you send.
  • This tool
GPT-4o (standard), output 10,000 per million tokens Tokens the model writes in its answer.
  • This tool
GPT-4o (standard), read from cache 1,250 per million tokens Tokens the model reads from a cached prompt. Cheaper than a fresh read.
  • This tool
Keyword planner data 50 per request Search volume and related keywords from advertising keyword-planner data. One request covers every seed you pass, and it is by a wide margin the dearest keyword source Botify offers.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Properties
keywords array required

List of keywords to get suggestions for

max items 20

question string required

What data to get from the keywords

location_request string | null

Location to get suggestions for.

Default: null

Example
{
  "keywords": [
    "string"
  ],
  "question": "string",
  "location_request": null
}

Configuration

object
Properties
location_id integer | null

Location ID (optional)

Default: null

location_request string | null

Location request (ex: Paris, FR), will translate to location ID

Default: null

country_code string | null

ISO3166 country code (ex: GB)

Default: null

lang_code string | null

BCP47 language code (ex: "en", "en-GB")

Default: null

device string

Device to use for search (optional - defaults to mobile)

Values: mobile desktop

Default: "mobile"

Example
{
  "location_id": null,
  "location_request": null,
  "country_code": null,
  "lang_code": null,
  "device": "mobile"
}

Response

object
Properties
answer string required

The answer to the question

results array required

List of keyword data

Example
{
  "answer": "string",
  "results": [
    {}
  ]
}

Endpoints

POST http://agents.botify.com/{organization}/{project}/keywords_suggestions_google_ads_planner/process
POST http://agents.botify.com/{organization}/{project}/keywords_suggestions_google_ads_planner/batch_process
POST http://agents.botify.com/{organization}/{project}/keywords_suggestions_google_ads_planner/async_process
POST http://agents.botify.com/{organization}/{project}/keywords_suggestions_google_ads_planner/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/keywords_suggestions_google_ads_planner/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {
    "keywords": [],
    "question": "<question>"
  }
}'

Raw metadata