Get Advertising Keyword Ideas with SEO API

POST/v1/seoapi/keywords/ads-ideas

One bounded SEO API request. Operator or admin only. Required Idempotency-Key is scoped to Team and capability. Keep the same key after timeout: unknown deliveries are never automatically repeated. Prices are published per capability in GET /v1/seoapi/capabilities; unpublished prices fail before quota or provider work. Complete deliveries capture the original price snapshot; partial or failed deliveries release Credits. Source records distinguish live search, keyword database and Google Ads data. Missing metrics remain null. X-SEOAPI-Request-ID on execution errors identifies the durable readback record.

On this page

Request example

Replace placeholders with your values. Use your Team API key for authenticated requests.

API base https://kieapi.com

curl -X POST "https://kieapi.com/v1/seoapi/keywords/ads-ideas" \
  -H "Authorization: Bearer $SPIDER_API_KEY" \
  -H 'Idempotency-Key: docs-example-01' \
  -H "Content-Type: application/json" \
  -d '{
  "keywords": [
    "example keyword"
  ],
  "country": "us",
  "language": "en"
}'

Authentication

BearerAuth

Parameters

Idempotency-Key header · string required

Request body required

application/json

SeoApiIdeasInput

engine string

Default: "google"

country string

Allowed: "us", "gb", "de", "fr", "ca", "au", "in", "jp", "br"

Default: "us"

language string or null

keywords array of string required

limit integer

Default: 100

{
  "keywords": [
    "example keyword"
  ],
  "country": "us",
  "language": "en"
}

Responses

200 Successful Response

application/json

SeoApiResponse

request_id string required
capability string required
status string required: Allowed: "success", "partial"
query object required
data SeoApiData required
source SeoApiSource required
coverage SeoApiCoverage required
billing SeoApiBilling required

400 Safe SEO API error; retain the request key after dispatch.

application/json

PublicErrorResponse

error PublicError required

401 Safe SEO API error; retain the request key after dispatch.

application/json

PublicErrorResponse

error PublicError required

402 Safe SEO API error; retain the request key after dispatch.

application/json

PublicErrorResponse

error PublicError required

403 Safe SEO API error; retain the request key after dispatch.

application/json

PublicErrorResponse

error PublicError required

404 Safe SEO API error; retain the request key after dispatch.

application/json

PublicErrorResponse

error PublicError required

409 Safe SEO API error; retain the request key after dispatch.

application/json

PublicErrorResponse

error PublicError required

429 Safe SEO API error; retain the request key after dispatch.

application/json

PublicErrorResponse

error PublicError required

502 Safe SEO API error; retain the request key after dispatch.

application/json

PublicErrorResponse

error PublicError required

503 Safe SEO API error; retain the request key after dispatch.

application/json

PublicErrorResponse

error PublicError required

Schemas

Field definitions and complete validation rules for this API. Follow a type link to its definition.

SeoApiIdeasInput

object

engine string

Default: "google"

country string

Allowed: "us", "gb", "de", "fr", "ca", "au", "in", "jp", "br"

Default: "us"

language string or null

keywords array of string required

limit integer

Default: 100

Complete schema

{
  "properties": {
    "engine": {
      "type": "string",
      "const": "google",
      "title": "Engine",
      "default": "google"
    },
    "country": {
      "type": "string",
      "enum": [
        "us",
        "gb",
        "de",
        "fr",
        "ca",
        "au",
        "in",
        "jp",
        "br"
      ],
      "title": "Country",
      "default": "us"
    },
    "language": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5
        },
        {
          "type": "null"
        }
      ],
      "title": "Language"
    },
    "keywords": {
      "items": {
        "type": "string",
        "maxLength": 80,
        "minLength": 1
      },
      "type": "array",
      "maxItems": 20,
      "minItems": 1,
      "title": "Keywords"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "title": "Limit",
      "default": 100
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "keywords"
  ],
  "title": "SeoApiIdeasInput"
}

SeoApiResponse

object

request_id string required
capability string required
status string required: Allowed: "success", "partial"
query object required
data SeoApiData required
source SeoApiSource required
coverage SeoApiCoverage required
billing SeoApiBilling required

Complete schema

{
  "properties": {
    "request_id": {
      "type": "string",
      "title": "Request Id"
    },
    "capability": {
      "type": "string",
      "title": "Capability"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "partial"
      ],
      "title": "Status"
    },
    "query": {
      "additionalProperties": true,
      "type": "object",
      "title": "Query"
    },
    "data": {
      "$ref": "#/components/schemas/SeoApiData"
    },
    "source": {
      "$ref": "#/components/schemas/SeoApiSource"
    },
    "coverage": {
      "$ref": "#/components/schemas/SeoApiCoverage"
    },
    "billing": {
      "$ref": "#/components/schemas/SeoApiBilling"
    }
  },
  "type": "object",
  "required": [
    "request_id",
    "capability",
    "status",
    "query",
    "data",
    "source",
    "coverage",
    "billing"
  ],
  "title": "SeoApiResponse"
}

SeoApiData

object

backlinks_summary SeoApiBacklinkSummary or null
backlinks array of SeoApiBacklink or null
referring_domains array of SeoApiReferringDomain or null
pages_summary array of SeoApiBacklinkPage or null
backlinks_history array of SeoApiBacklinkHistory or null
mentions array of SeoApiMention or null
mention_metrics SeoApiMentionMetrics or null
mention_pages array of SeoApiMentionPage or null
mention_comparisons array of SeoApiMentionComparison or null
llm_response SeoApiLlmResponse or null
keywords array of SeoApiKeyword or null
competitors array of SeoApiCompetitor or null
serp array of SeoApiSerpItem or null
result_count_estimate integer or null
check_url string or null
returned_keyword string or null
corrected_keyword string or null

Complete schema

{
  "properties": {
    "backlinks_summary": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/SeoApiBacklinkSummary"
        },
        {
          "type": "null"
        }
      ]
    },
    "backlinks": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiBacklink"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks"
    },
    "referring_domains": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiReferringDomain"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Domains"
    },
    "pages_summary": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiBacklinkPage"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pages Summary"
    },
    "backlinks_history": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiBacklinkHistory"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks History"
    },
    "mentions": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMention"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mentions"
    },
    "mention_metrics": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/SeoApiMentionMetrics"
        },
        {
          "type": "null"
        }
      ]
    },
    "mention_pages": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionPage"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mention Pages"
    },
    "mention_comparisons": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionComparison"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mention Comparisons"
    },
    "llm_response": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/SeoApiLlmResponse"
        },
        {
          "type": "null"
        }
      ]
    },
    "keywords": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiKeyword"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Keywords"
    },
    "competitors": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiCompetitor"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Competitors"
    },
    "serp": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiSerpItem"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Serp"
    },
    "result_count_estimate": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Result Count Estimate"
    },
    "check_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Check Url"
    },
    "returned_keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Returned Keyword"
    },
    "corrected_keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Corrected Keyword"
    }
  },
  "type": "object",
  "title": "SeoApiData"
}

SeoApiBacklinkSummary

object

rank integer or null
backlinks integer or null required
backlinks_spam_score number or null
referring_domains integer or null
referring_main_domains integer or null
referring_pages integer or null
referring_pages_nofollow integer or null
referring_ips integer or null
referring_subnets integer or null
broken_backlinks integer or null
broken_pages integer or null
first_seen string or null
lost_date string or null
referring_links_tld object or null
referring_links_types object or null
referring_links_attributes object or null
referring_links_countries object or null
target string required
crawled_pages integer or null
internal_links_count integer or null
external_links_count integer or null

Complete schema

{
  "properties": {
    "rank": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 1000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rank"
    },
    "backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks"
    },
    "backlinks_spam_score": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks Spam Score"
    },
    "referring_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Domains"
    },
    "referring_main_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Main Domains"
    },
    "referring_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Pages"
    },
    "referring_pages_nofollow": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Pages Nofollow"
    },
    "referring_ips": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Ips"
    },
    "referring_subnets": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Subnets"
    },
    "broken_backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Broken Backlinks"
    },
    "broken_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Broken Pages"
    },
    "first_seen": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "First Seen"
    },
    "lost_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lost Date"
    },
    "referring_links_tld": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Tld"
    },
    "referring_links_types": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Types"
    },
    "referring_links_attributes": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Attributes"
    },
    "referring_links_countries": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Countries"
    },
    "target": {
      "type": "string",
      "title": "Target"
    },
    "crawled_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Crawled Pages"
    },
    "internal_links_count": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Internal Links Count"
    },
    "external_links_count": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "External Links Count"
    }
  },
  "type": "object",
  "required": [
    "backlinks",
    "target"
  ],
  "title": "SeoApiBacklinkSummary"
}

SeoApiBacklink

object

url_from string required
url_to string required
domain_from string or null
domain_to string or null
anchor string or null
dofollow boolean or null
rank integer or null
page_from_rank integer or null
domain_from_rank integer or null
backlink_spam_score number or null
first_seen string or null
last_seen string or null
is_new boolean or null
is_lost boolean or null
is_broken boolean or null
page_from_title string or null
page_from_language string or null
page_from_status_code integer or null
url_to_status_code integer or null
item_type string or null
links_count integer or null

Complete schema

{
  "properties": {
    "url_from": {
      "type": "string",
      "title": "Url From"
    },
    "url_to": {
      "type": "string",
      "title": "Url To"
    },
    "domain_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Domain From"
    },
    "domain_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Domain To"
    },
    "anchor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Anchor"
    },
    "dofollow": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dofollow"
    },
    "rank": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 1000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rank"
    },
    "page_from_rank": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 1000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Page From Rank"
    },
    "domain_from_rank": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 1000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Domain From Rank"
    },
    "backlink_spam_score": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlink Spam Score"
    },
    "first_seen": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "First Seen"
    },
    "last_seen": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last Seen"
    },
    "is_new": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is New"
    },
    "is_lost": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Lost"
    },
    "is_broken": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Broken"
    },
    "page_from_title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Page From Title"
    },
    "page_from_language": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Page From Language"
    },
    "page_from_status_code": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Page From Status Code"
    },
    "url_to_status_code": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Url To Status Code"
    },
    "item_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Item Type"
    },
    "links_count": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Links Count"
    }
  },
  "type": "object",
  "required": [
    "url_from",
    "url_to"
  ],
  "title": "SeoApiBacklink"
}

SeoApiReferringDomain

object

rank integer or null
backlinks integer or null required
backlinks_spam_score number or null
referring_domains integer or null
referring_main_domains integer or null
referring_pages integer or null
referring_pages_nofollow integer or null
referring_ips integer or null
referring_subnets integer or null
broken_backlinks integer or null
broken_pages integer or null
first_seen string or null
lost_date string or null
referring_links_tld object or null
referring_links_types object or null
referring_links_attributes object or null
referring_links_countries object or null
domain string required

Complete schema

{
  "properties": {
    "rank": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 1000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rank"
    },
    "backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks"
    },
    "backlinks_spam_score": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks Spam Score"
    },
    "referring_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Domains"
    },
    "referring_main_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Main Domains"
    },
    "referring_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Pages"
    },
    "referring_pages_nofollow": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Pages Nofollow"
    },
    "referring_ips": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Ips"
    },
    "referring_subnets": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Subnets"
    },
    "broken_backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Broken Backlinks"
    },
    "broken_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Broken Pages"
    },
    "first_seen": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "First Seen"
    },
    "lost_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lost Date"
    },
    "referring_links_tld": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Tld"
    },
    "referring_links_types": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Types"
    },
    "referring_links_attributes": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Attributes"
    },
    "referring_links_countries": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Countries"
    },
    "domain": {
      "type": "string",
      "title": "Domain"
    }
  },
  "type": "object",
  "required": [
    "backlinks",
    "domain"
  ],
  "title": "SeoApiReferringDomain"
}

SeoApiBacklinkPage

object

rank integer or null
backlinks integer or null required
backlinks_spam_score number or null
referring_domains integer or null
referring_main_domains integer or null
referring_pages integer or null
referring_pages_nofollow integer or null
referring_ips integer or null
referring_subnets integer or null
broken_backlinks integer or null
broken_pages integer or null
first_seen string or null
lost_date string or null
referring_links_tld object or null
referring_links_types object or null
referring_links_attributes object or null
referring_links_countries object or null
url string required

Complete schema

{
  "properties": {
    "rank": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 1000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rank"
    },
    "backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks"
    },
    "backlinks_spam_score": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks Spam Score"
    },
    "referring_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Domains"
    },
    "referring_main_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Main Domains"
    },
    "referring_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Pages"
    },
    "referring_pages_nofollow": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Pages Nofollow"
    },
    "referring_ips": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Ips"
    },
    "referring_subnets": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Subnets"
    },
    "broken_backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Broken Backlinks"
    },
    "broken_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Broken Pages"
    },
    "first_seen": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "First Seen"
    },
    "lost_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lost Date"
    },
    "referring_links_tld": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Tld"
    },
    "referring_links_types": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Types"
    },
    "referring_links_attributes": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Attributes"
    },
    "referring_links_countries": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Countries"
    },
    "url": {
      "type": "string",
      "title": "Url"
    }
  },
  "type": "object",
  "required": [
    "backlinks",
    "url"
  ],
  "title": "SeoApiBacklinkPage"
}

SeoApiBacklinkHistory

object

rank integer or null
backlinks integer or null required
backlinks_spam_score number or null
referring_domains integer or null
referring_main_domains integer or null
referring_pages integer or null
referring_pages_nofollow integer or null
referring_ips integer or null
referring_subnets integer or null
broken_backlinks integer or null
broken_pages integer or null
first_seen string or null
lost_date string or null
referring_links_tld object or null
referring_links_types object or null
referring_links_attributes object or null
referring_links_countries object or null
date string required
new_backlinks integer or null
lost_backlinks integer or null
new_referring_domains integer or null
lost_referring_domains integer or null
crawled_pages integer or null

Complete schema

{
  "properties": {
    "rank": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 1000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rank"
    },
    "backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks"
    },
    "backlinks_spam_score": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Backlinks Spam Score"
    },
    "referring_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Domains"
    },
    "referring_main_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Main Domains"
    },
    "referring_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Pages"
    },
    "referring_pages_nofollow": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Pages Nofollow"
    },
    "referring_ips": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Ips"
    },
    "referring_subnets": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Subnets"
    },
    "broken_backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Broken Backlinks"
    },
    "broken_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Broken Pages"
    },
    "first_seen": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "First Seen"
    },
    "lost_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lost Date"
    },
    "referring_links_tld": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Tld"
    },
    "referring_links_types": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Types"
    },
    "referring_links_attributes": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Attributes"
    },
    "referring_links_countries": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Referring Links Countries"
    },
    "date": {
      "type": "string",
      "title": "Date"
    },
    "new_backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "New Backlinks"
    },
    "lost_backlinks": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Lost Backlinks"
    },
    "new_referring_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "New Referring Domains"
    },
    "lost_referring_domains": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Lost Referring Domains"
    },
    "crawled_pages": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Crawled Pages"
    }
  },
  "type": "object",
  "required": [
    "backlinks",
    "date"
  ],
  "title": "SeoApiBacklinkHistory"
}

SeoApiMention

object

platform string required: Allowed: "google", "chatgpt"
model string required
country string required
language string required
question string required
answer string required
ai_search_volume integer or null
sources array of SeoApiCitation or null
search_results array of SeoApiCitation or null
brand_entities array of SeoApiBrand or null
fan_out_queries array of string or null
first_response_at string or null
last_response_at string or null

Complete schema

{
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "google",
        "chatgpt"
      ],
      "title": "Platform"
    },
    "model": {
      "type": "string",
      "title": "Model"
    },
    "country": {
      "type": "string",
      "title": "Country"
    },
    "language": {
      "type": "string",
      "title": "Language"
    },
    "question": {
      "type": "string",
      "title": "Question"
    },
    "answer": {
      "type": "string",
      "title": "Answer"
    },
    "ai_search_volume": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Ai Search Volume"
    },
    "sources": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiCitation"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sources"
    },
    "search_results": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiCitation"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Search Results"
    },
    "brand_entities": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiBrand"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Brand Entities"
    },
    "fan_out_queries": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fan Out Queries"
    },
    "first_response_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "First Response At"
    },
    "last_response_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last Response At"
    }
  },
  "type": "object",
  "required": [
    "platform",
    "model",
    "country",
    "language",
    "question",
    "answer"
  ],
  "title": "SeoApiMention"
}

SeoApiCitation

object

url string required
title string or null
domain string or null
description string or null
position integer or null
direct_url string or null
start_index integer or null
end_index integer or null
text string or null

Complete schema

{
  "properties": {
    "url": {
      "type": "string",
      "title": "Url"
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Title"
    },
    "domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Domain"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Description"
    },
    "position": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Position"
    },
    "direct_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Direct Url"
    },
    "start_index": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Start Index"
    },
    "end_index": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "End Index"
    },
    "text": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Text"
    }
  },
  "type": "object",
  "required": [
    "url"
  ],
  "title": "SeoApiCitation"
}

SeoApiBrand

object

title string required
category string or null
position integer or null

Complete schema

{
  "properties": {
    "title": {
      "type": "string",
      "title": "Title"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Category"
    },
    "position": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Position"
    }
  },
  "type": "object",
  "required": [
    "title"
  ],
  "title": "SeoApiBrand"
}

SeoApiMentionMetrics

object

total SeoApiMentionTotal required
countries array of SeoApiMentionBucket or null
languages array of SeoApiMentionBucket or null
platforms array of SeoApiMentionBucket or null
source_domains array of SeoApiMentionBucket or null
search_result_domains array of SeoApiMentionBucket or null
brands array of SeoApiMentionBucket or null
brand_categories array of SeoApiMentionBucket or null

Complete schema

{
  "properties": {
    "total": {
      "$ref": "#/components/schemas/SeoApiMentionTotal"
    },
    "countries": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Countries"
    },
    "languages": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Languages"
    },
    "platforms": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Platforms"
    },
    "source_domains": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Domains"
    },
    "search_result_domains": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Search Result Domains"
    },
    "brands": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Brands"
    },
    "brand_categories": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Brand Categories"
    }
  },
  "type": "object",
  "required": [
    "total"
  ],
  "title": "SeoApiMentionMetrics"
}

SeoApiMentionTotal

object

mentions integer or null required
ai_search_volume integer or null required

Complete schema

{
  "properties": {
    "mentions": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Mentions"
    },
    "ai_search_volume": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Ai Search Volume"
    }
  },
  "type": "object",
  "required": [
    "mentions",
    "ai_search_volume"
  ],
  "title": "SeoApiMentionTotal"
}

SeoApiMentionBucket

object

mentions integer or null required
ai_search_volume integer or null required
key string required

Complete schema

{
  "properties": {
    "mentions": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Mentions"
    },
    "ai_search_volume": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Ai Search Volume"
    },
    "key": {
      "type": "string",
      "title": "Key"
    }
  },
  "type": "object",
  "required": [
    "mentions",
    "ai_search_volume",
    "key"
  ],
  "title": "SeoApiMentionBucket"
}

SeoApiMentionPage

object

total SeoApiMentionTotal required
countries array of SeoApiMentionBucket or null
languages array of SeoApiMentionBucket or null
platforms array of SeoApiMentionBucket or null
source_domains array of SeoApiMentionBucket or null
search_result_domains array of SeoApiMentionBucket or null
brands array of SeoApiMentionBucket or null
brand_categories array of SeoApiMentionBucket or null
url string required

Complete schema

{
  "properties": {
    "total": {
      "$ref": "#/components/schemas/SeoApiMentionTotal"
    },
    "countries": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Countries"
    },
    "languages": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Languages"
    },
    "platforms": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Platforms"
    },
    "source_domains": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Domains"
    },
    "search_result_domains": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Search Result Domains"
    },
    "brands": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Brands"
    },
    "brand_categories": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Brand Categories"
    },
    "url": {
      "type": "string",
      "title": "Url"
    }
  },
  "type": "object",
  "required": [
    "total",
    "url"
  ],
  "title": "SeoApiMentionPage"
}

SeoApiMentionComparison

object

total SeoApiMentionTotal required
countries array of SeoApiMentionBucket or null
languages array of SeoApiMentionBucket or null
platforms array of SeoApiMentionBucket or null
source_domains array of SeoApiMentionBucket or null
search_result_domains array of SeoApiMentionBucket or null
brands array of SeoApiMentionBucket or null
brand_categories array of SeoApiMentionBucket or null
key string required

Complete schema

{
  "properties": {
    "total": {
      "$ref": "#/components/schemas/SeoApiMentionTotal"
    },
    "countries": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Countries"
    },
    "languages": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Languages"
    },
    "platforms": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Platforms"
    },
    "source_domains": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Domains"
    },
    "search_result_domains": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Search Result Domains"
    },
    "brands": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Brands"
    },
    "brand_categories": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMentionBucket"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Brand Categories"
    },
    "key": {
      "type": "string",
      "title": "Key"
    }
  },
  "type": "object",
  "required": [
    "total",
    "key"
  ],
  "title": "SeoApiMentionComparison"
}

SeoApiLlmResponse

object

output_limit_reached boolean required
platform string required: Allowed: "chatgpt", "claude", "gemini"
model string required
sections array of SeoApiAnswerSection required
usage SeoApiLlmUsage required
web_search boolean required
generated_at string or null
fan_out_queries array of string or null

Complete schema

{
  "properties": {
    "output_limit_reached": {
      "type": "boolean",
      "title": "Output Limit Reached"
    },
    "platform": {
      "type": "string",
      "enum": [
        "chatgpt",
        "claude",
        "gemini"
      ],
      "title": "Platform"
    },
    "model": {
      "type": "string",
      "title": "Model"
    },
    "sections": {
      "items": {
        "$ref": "#/components/schemas/SeoApiAnswerSection"
      },
      "type": "array",
      "title": "Sections"
    },
    "usage": {
      "$ref": "#/components/schemas/SeoApiLlmUsage"
    },
    "web_search": {
      "type": "boolean",
      "title": "Web Search"
    },
    "generated_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Generated At"
    },
    "fan_out_queries": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fan Out Queries"
    }
  },
  "type": "object",
  "required": [
    "output_limit_reached",
    "platform",
    "model",
    "sections",
    "usage",
    "web_search"
  ],
  "title": "SeoApiLlmResponse"
}

SeoApiAnswerSection

object

text string required
citations array of SeoApiCitation required

Complete schema

{
  "properties": {
    "text": {
      "type": "string",
      "title": "Text"
    },
    "citations": {
      "items": {
        "$ref": "#/components/schemas/SeoApiCitation"
      },
      "type": "array",
      "title": "Citations"
    }
  },
  "type": "object",
  "required": [
    "text",
    "citations"
  ],
  "title": "SeoApiAnswerSection"
}

SeoApiLlmUsage

object

input_tokens integer or null required
output_tokens integer or null required
reasoning_tokens integer or null required

Complete schema

{
  "properties": {
    "input_tokens": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Input Tokens"
    },
    "output_tokens": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Output Tokens"
    },
    "reasoning_tokens": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Reasoning Tokens"
    }
  },
  "type": "object",
  "required": [
    "input_tokens",
    "output_tokens",
    "reasoning_tokens"
  ],
  "title": "SeoApiLlmUsage"
}

SeoApiKeyword

object

keyword string required
search_volume integer or null
cpc number or null
ads_competition_index number or null
ads_competition_level string or null
keyword_difficulty number or null
search_intent string or null
updated_at string or null
monthly_searches array of SeoApiMonthlyVolume or null

Complete schema

{
  "properties": {
    "keyword": {
      "type": "string",
      "title": "Keyword"
    },
    "search_volume": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Search Volume"
    },
    "cpc": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpc"
    },
    "ads_competition_index": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ads Competition Index"
    },
    "ads_competition_level": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ads Competition Level"
    },
    "keyword_difficulty": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Keyword Difficulty"
    },
    "search_intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Search Intent"
    },
    "updated_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Updated At"
    },
    "monthly_searches": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/components/schemas/SeoApiMonthlyVolume"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Monthly Searches"
    }
  },
  "type": "object",
  "required": [
    "keyword"
  ],
  "title": "SeoApiKeyword"
}

SeoApiMonthlyVolume

object

year integer required
month integer required
search_volume integer or null

Complete schema

{
  "properties": {
    "year": {
      "type": "integer",
      "title": "Year"
    },
    "month": {
      "type": "integer",
      "maximum": 12,
      "minimum": 1,
      "title": "Month"
    },
    "search_volume": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Search Volume"
    }
  },
  "type": "object",
  "required": [
    "year",
    "month"
  ],
  "title": "SeoApiMonthlyVolume"
}

SeoApiCompetitor

object

domain string required
average_position number or null
keyword_count integer or null
estimated_traffic number or null
visibility number or null

Complete schema

{
  "properties": {
    "domain": {
      "type": "string",
      "title": "Domain"
    },
    "average_position": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Average Position"
    },
    "keyword_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Keyword Count"
    },
    "estimated_traffic": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Estimated Traffic"
    },
    "visibility": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Visibility"
    }
  },
  "type": "object",
  "required": [
    "domain"
  ],
  "title": "SeoApiCompetitor"
}

SeoApiSerpItem

object

type string required
rank integer or null
absolute_rank integer or null
url string or null
title string or null
description string or null

Complete schema

{
  "properties": {
    "type": {
      "type": "string",
      "title": "Type"
    },
    "rank": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Rank"
    },
    "absolute_rank": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Absolute Rank"
    },
    "url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Url"
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Title"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Description"
    }
  },
  "type": "object",
  "required": [
    "type"
  ],
  "title": "SeoApiSerpItem"
}

SeoApiSource

object

provider string required
dataset string required
method string required: Allowed: "live", "database", "ads_dataset", "backlink_index", "mentions_database", "llm"
engine string or null required
country string or null required
language string or null required
observed_at string required
data_timestamp string or null

Complete schema

{
  "properties": {
    "provider": {
      "type": "string",
      "title": "Provider"
    },
    "dataset": {
      "type": "string",
      "title": "Dataset"
    },
    "method": {
      "type": "string",
      "enum": [
        "live",
        "database",
        "ads_dataset",
        "backlink_index",
        "mentions_database",
        "llm"
      ],
      "title": "Method"
    },
    "engine": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Engine"
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Country"
    },
    "language": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Language"
    },
    "observed_at": {
      "type": "string",
      "title": "Observed At"
    },
    "data_timestamp": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Data Timestamp"
    }
  },
  "type": "object",
  "required": [
    "provider",
    "dataset",
    "method",
    "engine",
    "country",
    "language",
    "observed_at"
  ],
  "title": "SeoApiSource"
}

SeoApiCoverage

object

incomplete_reasons array of string
returned_count integer required
available_count integer or null required
truncated boolean required
missing_keywords array of string required

Complete schema

{
  "properties": {
    "incomplete_reasons": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Incomplete Reasons"
    },
    "returned_count": {
      "type": "integer",
      "title": "Returned Count"
    },
    "available_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Available Count"
    },
    "truncated": {
      "type": "boolean",
      "title": "Truncated"
    },
    "missing_keywords": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Missing Keywords"
    }
  },
  "type": "object",
  "required": [
    "returned_count",
    "available_count",
    "truncated",
    "missing_keywords"
  ],
  "title": "SeoApiCoverage"
}

SeoApiBilling

object

status string required
credits integer required
price_book_version string required

Complete schema

{
  "properties": {
    "status": {
      "type": "string",
      "title": "Status"
    },
    "credits": {
      "type": "integer",
      "title": "Credits"
    },
    "price_book_version": {
      "type": "string",
      "title": "Price Book Version"
    }
  },
  "type": "object",
  "required": [
    "status",
    "credits",
    "price_book_version"
  ],
  "title": "SeoApiBilling"
}

PublicErrorResponse

object

error PublicError required

Complete schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "$ref": "#/components/schemas/PublicError"
    }
  }
}

PublicError

object

code string required: Allowed: "seoapi_price_pending", "seoapi_unavailable", "seoapi_busy", "seoapi_not_found", "seoapi_rate_limited", "seoapi_budget_exceeded", "seoapi_idempotency_conflict", "seoapi_insufficient_credits", "seoapi_admission_failed", "seoapi_execution_interrupted", "seoapi_delivery_unknown", "seoapi_response_invalid", "seoapi_model_unsupported", "seoapi_model_options_invalid", "seoapi_provider_rejected", "seo_price_pending", "seo_provider_blocked", "seo_local_rate_limited", "seo_fallback_unavailable", "seo_fallback_budget_exceeded", "seo_pagination_expired", "seo_delivery_uncertain", "seo_auth_required", "seo_initialization_required", "seo_permission_denied", "seo_verification_required", "seo_rate_limited", "seo_upstream_unavailable", "seo_transport_failed", "seo_invalid_response", "seo_rpc_error", "seo_period_unavailable", "seo_account_unavailable", "seo_session_busy", "seo_configuration_required", "validation_error", "invalid_request", "unsupported_feature", "authentication_required", "permission_denied", "not_found", "run_not_found", "crawl_not_found", "artifact_not_found", "session_not_found", "profile_not_found", "profile_in_use", "profile_not_ready", "profile_not_cloneable", "profile_limit_reached", "profile_proxy_conflict", "proxy_not_found", "proxy_unavailable", "invalid_session_options", "invalid_query_options", "invalid_cursor", "idempotency_key_required", "browser_session_limit_reached", "browser_capacity_exhausted", "browser_start_timeout", "browser_runtime_unavailable", "session_not_active", "controller_already_connected", "browser_relay_unavailable", "precondition_required", "precondition_failed", "timeout", "run_not_ready", "artifact_expired", "quota_exceeded", "insufficient_credits", "billing_reconciliation_required", "rate_limited", "fetch_failed", "render_failed", "maps_rate_limited", "maps_challenge", "maps_schema_changed", "maps_invalid_response", "maps_transport_failed", "maps_page_budget_exhausted", "google_trends_rate_limited", "google_trends_challenge", "google_trends_explore_failed", "google_trends_widget_missing", "google_trends_related_failed", "google_trends_invalid_response", "google_trends_transport_failed", "google_trends_collection_failed", "google_ads_account_context_missing", "google_ads_batch_failed", "google_ads_browser_context_missing", "google_ads_browser_unavailable", "google_ads_collection_failed", "google_ads_page_failed", "google_ads_protocol_drift", "google_ads_rate_limited", "google_ads_timeout", "twitter_provider_unavailable", "twitter_provider_rejected", "twitter_submission_unknown", "wechat_transport_failed", "wechat_rate_limited", "wechat_invalid_response", "wechat_redirect_rejected", "wechat_verification_required", "wechat_parse_failed", "blackhatworld_search_failed", "blackhatworld_no_results", "reddit_read_failed", "idempotency_conflict", "idempotency_in_progress", "service_unavailable", "internal_error"
message string required
type string required: Allowed: "auth", "validation", "quota", "rate_limit", "not_found", "execution", "conflict", "internal"
retryable boolean required
request_id string | null
details object

Complete schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "code",
    "message",
    "type",
    "retryable"
  ],
  "properties": {
    "code": {
      "type": "string",
      "enum": [
        "seoapi_price_pending",
        "seoapi_unavailable",
        "seoapi_busy",
        "seoapi_not_found",
        "seoapi_rate_limited",
        "seoapi_budget_exceeded",
        "seoapi_idempotency_conflict",
        "seoapi_insufficient_credits",
        "seoapi_admission_failed",
        "seoapi_execution_interrupted",
        "seoapi_delivery_unknown",
        "seoapi_response_invalid",
        "seoapi_model_unsupported",
        "seoapi_model_options_invalid",
        "seoapi_provider_rejected",
        "seo_price_pending",
        "seo_provider_blocked",
        "seo_local_rate_limited",
        "seo_fallback_unavailable",
        "seo_fallback_budget_exceeded",
        "seo_pagination_expired",
        "seo_delivery_uncertain",
        "seo_auth_required",
        "seo_initialization_required",
        "seo_permission_denied",
        "seo_verification_required",
        "seo_rate_limited",
        "seo_upstream_unavailable",
        "seo_transport_failed",
        "seo_invalid_response",
        "seo_rpc_error",
        "seo_period_unavailable",
        "seo_account_unavailable",
        "seo_session_busy",
        "seo_configuration_required",
        "validation_error",
        "invalid_request",
        "unsupported_feature",
        "authentication_required",
        "permission_denied",
        "not_found",
        "run_not_found",
        "crawl_not_found",
        "artifact_not_found",
        "session_not_found",
        "profile_not_found",
        "profile_in_use",
        "profile_not_ready",
        "profile_not_cloneable",
        "profile_limit_reached",
        "profile_proxy_conflict",
        "proxy_not_found",
        "proxy_unavailable",
        "invalid_session_options",
        "invalid_query_options",
        "invalid_cursor",
        "idempotency_key_required",
        "browser_session_limit_reached",
        "browser_capacity_exhausted",
        "browser_start_timeout",
        "browser_runtime_unavailable",
        "session_not_active",
        "controller_already_connected",
        "browser_relay_unavailable",
        "precondition_required",
        "precondition_failed",
        "timeout",
        "run_not_ready",
        "artifact_expired",
        "quota_exceeded",
        "insufficient_credits",
        "billing_reconciliation_required",
        "rate_limited",
        "fetch_failed",
        "render_failed",
        "maps_rate_limited",
        "maps_challenge",
        "maps_schema_changed",
        "maps_invalid_response",
        "maps_transport_failed",
        "maps_page_budget_exhausted",
        "google_trends_rate_limited",
        "google_trends_challenge",
        "google_trends_explore_failed",
        "google_trends_widget_missing",
        "google_trends_related_failed",
        "google_trends_invalid_response",
        "google_trends_transport_failed",
        "google_trends_collection_failed",
        "google_ads_account_context_missing",
        "google_ads_batch_failed",
        "google_ads_browser_context_missing",
        "google_ads_browser_unavailable",
        "google_ads_collection_failed",
        "google_ads_page_failed",
        "google_ads_protocol_drift",
        "google_ads_rate_limited",
        "google_ads_timeout",
        "twitter_provider_unavailable",
        "twitter_provider_rejected",
        "twitter_submission_unknown",
        "wechat_transport_failed",
        "wechat_rate_limited",
        "wechat_invalid_response",
        "wechat_redirect_rejected",
        "wechat_verification_required",
        "wechat_parse_failed",
        "blackhatworld_search_failed",
        "blackhatworld_no_results",
        "reddit_read_failed",
        "idempotency_conflict",
        "idempotency_in_progress",
        "service_unavailable",
        "internal_error"
      ]
    },
    "message": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "auth",
        "validation",
        "quota",
        "rate_limit",
        "not_found",
        "execution",
        "conflict",
        "internal"
      ]
    },
    "retryable": {
      "type": "boolean"
    },
    "request_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "details": {
      "type": "object",
      "additionalProperties": true
    }
  }
}