Skip to main content
SEO gives your agent search-optimization data through three sub-APIs — Keywords Data, Backlinks, and SEO Labs. Every live keyword endpoint also supports the Standard (async) method for batch workflows.

CLI First

SDK

Per-user and AccountKit-gated; usage is metered against the tenant’s plan (see Customer Billing). Full surface in the seo sub-client; also available to agents via agentTools().

Sub-APIs

Quick Examples


Keywords Data API

Keywords Data provides search volume, keyword suggestions, and ad traffic estimates across Google, Bing, and Google Trends. Each data endpoint supports both Live (instant results via POST) and Standard (async task via POST + GET) modes.

Google Endpoints

Google Meta Endpoints

Bing Endpoints

Bing Meta Endpoints

Utility

Live vs Standard Mode

Every data endpoint (not meta) supports two modes:
  • LivePOST /v1/seo/keywords/{engine}/{endpoint} — instant results in the response body.
  • Standard — submit via POST .../task, check readiness via GET .../tasks-ready, retrieve via GET .../task/:id.
Response (Live — search-volume):

Parameters

When to use

  • Estimating keyword search volume before creating content
  • Discovering related keywords for topic clusters
  • Analyzing ad traffic and CPC for paid campaigns
  • Tracking keyword trends over time via Google Trends
  • Comparing keyword performance across Google and Bing
  • Finding keywords competitors are buying ads for

The Backlinks API provides instant backlink profile data — referring domains, anchor texts, competitors, and bulk analysis. All endpoints use the Live method (instant POST results).

Live POST Endpoints

GET Endpoints

Other

Response (summary):

Parameters

When to use

  • Auditing your own backlink profile for toxic links
  • Analyzing competitor link-building strategies
  • Finding link prospects via domain/page intersection
  • Bulk-checking spam scores for link cleanup campaigns
  • Tracking new/lost backlinks over time
  • Comparing referring domain counts across competitors

SEO Labs API

Labs endpoints provide keyword research, competitor analysis, and SERP insights using a proprietary SEO database. All use the Live method — instant POST results. Available for Google, Bing, and Amazon.

Google Endpoints (23)

Bing Endpoints (11)

Amazon Endpoints (6)

Utility GET Endpoints

Labs keyword endpoints (e.g. keyword-overview) require both a location and a language. location_code (default 2840, United States) and language_code (default en) are applied automatically when omitted; pass them (or the CLI’s --location/--language) to override.
Response (keyword-overview):

Parameters

When to use

  • Getting keyword difficulty scores before targeting terms
  • Finding competitor keywords you’re missing (domain-intersection)
  • Analyzing SERP competition for specific terms
  • Estimating traffic potential for domains in bulk
  • Classifying search intent for content strategy
  • Researching Amazon product keyword opportunities

Credit Costs

Credits are charged when a request is made (or a task submitted) — the provider bills only for setting a task, so collecting the results is free. The figures above are list prices. Backlinks and Labs bill the provider per returned row, so an unusually large response settles above the list price; the credits_used field on every response is the amount actually charged.

Error Handling

Use the naive_seo_discover MCP tool to find the right endpoint for your use case — it supports natural language filtering across all 90+ SEO endpoints.

Typical Workflow

See also (blog)