Agentic Platform
Documentation API reference Tools Skills

Tools

Keywords performance for URL (From Google Search Console)

url_keywords MCP Keywords Google

Get GSC keywords for a given URL.

Get Google Search Console keyword performance metrics for a specific URL (i.e., clicks, impressions, position).

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
url required The URL to analyze.
period required Time period to analyze.

Billing

Fixed cost per item requested. This tool reads data Botify already holds for your project and calls no outside service, so nothing is added to the per-call price.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item.

Schemas

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

Item

object
Properties
url string required

The URL to analyze.

period string required

Time period to analyze.

Values: last_7d last_30d last_90d

Example
{
  "url": "string",
  "period": "last_7d"
}

Response

object
Properties
project_metadata ProjectMetadataProcessedItem required

Project metadata information.

Type: ProjectMetadataProcessedItem

period string required

The time period analyzed.

keywords array required

List of keyword performance metrics.

Items: KeywordPerformance

metrics object required

Top-level metrics for the URL.

estimated_revenue number required

Estimated revenue based on keyword performance.

estimated_revenue_currency string required

Currency of the estimated revenue.

predictions_agg object required

Aggregated predictions for different devices.

estimated_revenue_comments string required

Comments on how the estimated revenue was calculated.

keywords_comments string | null

Comments on the keyword performance metrics provided.

Default: null

Example
{
  "project_metadata": {
    "values": {},
    "not_set_values": null,
    "message": null
  },
  "period": "string",
  "keywords": [
    {
      "keyword": "string",
      "clicks": 0.0,
      "impressions": 0.0,
      "position": 0.0,
      "ctr": 0.0,
      "estimated_revenue": 0.0,
      "predictions": {},
      "smart_keyword_in_metadata": null
    }
  ],
  "metrics": {},
  "estimated_revenue": 0.0,
  "estimated_revenue_currency": "string",
  "predictions_agg": {},
  "estimated_revenue_comments": "string",
  "keywords_comments": null
}

Type Definitions

2 types

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

KeywordPerformance object
#
keyword string | null required

The keyword.

clicks number required

Number of clicks.

impressions number required

Number of impressions.

position number | null required

Average position.

ctr number | null required

Click-through rate (CTR).

estimated_revenue number required

Estimated revenue for this keyword.

predictions object | null required

Predicted metrics for different devices.

smart_keyword_in_metadata boolean | null

Whether the keyword is present in the page title or description.

Default: null

ProjectMetadataProcessedItem object
#
values object required

Retrieved metadata values

not_set_values array | null

Keys that were requested but not set

Default: null

message string | null

Message describing the result

Default: null

Endpoints

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

Over MCP

This tool is exposed as the MCP tool url_keywords. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata