Keyword ideas suggest

Expand one seed keyword into prioritized long-tail keyword ideas with search metrics. Costs 4 credits.

post/keyword-ideas/suggest

Request

  • Base URL: https://www.agentseo.dev/api/v1
  • URL: https://www.agentseo.dev/api/v1/keyword-ideas/suggest
  • Auth: API key in header x-api-key

Query parameters

syncboolean

Open a short inline processing window when supported by the endpoint. If the result is not ready yet, the endpoint may still return 202 with a queued payload that includes poll_url, events_url, and retry_after_seconds.

Headers

x-project-idstring

Optional attribution label for grouping usage and jobs by project.

x-workflow-idstring

Optional attribution label for grouping usage and jobs by workflow or agent run.

Request body

keywordstring required

Seed keyword or topic.

locationstring

Human-friendly search market. If provided with location_code, location_code wins.

location_codeinteger

Optional provider location code for deterministic geo-targeting.

languagestring
limitinteger
min_search_volumeinteger
include_seed_keywordboolean
exact_matchboolean
ignore_synonymsboolean

Response

Completed keyword ideas workflow with agent_workflow

seed_keywordstring
locationobject
keyword_ideasobject
markdown_summarystring

Changes

No recorded changes to this operation across all 1 revision of this API.