Agentic Platform
Documentation API reference Tools Skills

Tools

Google Ads Search Volume

google_ads_search_volume Keywords Competitive analysis

Fetches Google Ads search volume data for keywords.

This agent retrieves Google Ads search volume data for specified keywords. It provides information including: - Monthly average search volume - Competition level and index - Cost per click (CPC) - Top of page bid estimates - Monthly search volume history - Location and language targeting data The agent supports location and language targeting to get region-specific search volume data.

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
query required The keyword to analyze. Limited to 80 characters.
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 data request. That request covers every keyword you pass, and keyword planner data is by a wide margin the dearest keyword source Botify offers.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item, on top of any usage below.
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
query string required

The keyword to analyze. Limited to 80 characters.

max length 80

Example
{
  "query": "string"
}

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

Processed item containing Google Ads search volume data.

Properties
keyword string required

The keyword that was searched

search_volume integer | null required

Monthly average search volume

competition string | null required

Competition level (HIGH, MEDIUM, LOW)

competition_index integer | null required

Competition index (0-100)

cpc number | null required

Cost per click

low_top_of_page_bid number | null required

Minimum bid for top of page

high_top_of_page_bid number | null required

Maximum bid for top of page

monthly_searches MonthlySearchData required

Monthly search volume data

Items: MonthlySearchData

location_code integer | null required

Location code used for search

language_code string | null required

Language code used for search

search_partners boolean | null required

Whether search partners data is included

Example
{
  "keyword": "string",
  "search_volume": 0,
  "competition": "string",
  "competition_index": 0,
  "cpc": 0.0,
  "low_top_of_page_bid": 0.0,
  "high_top_of_page_bid": 0.0,
  "monthly_searches": [
    {
      "year": 0,
      "month": 0,
      "search_volume": 0
    }
  ],
  "location_code": 0,
  "language_code": "string",
  "search_partners": true
}

Type Definitions

1 type

These are the available sub-object types that can be used in the properties above.

MonthlySearchData object
#

Monthly search volume data for a keyword.

year integer required
month integer required
search_volume integer required

Endpoints

POST http://agents.botify.com/{organization}/{project}/google_ads_search_volume/process
POST http://agents.botify.com/{organization}/{project}/google_ads_search_volume/batch_process
POST http://agents.botify.com/{organization}/{project}/google_ads_search_volume/async_process
POST http://agents.botify.com/{organization}/{project}/google_ads_search_volume/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}/google_ads_search_volume/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {
    "query": "<query>"
  }
}'

Raw metadata