API docs v1

API reference / Resource

SEO keywords

Track Google keywords for a brand: positions over time, search volume and difficulty, keyword research, the organic overview and keyword gap against competitors, and the Google keyword behind each AI prompt. Buying provider data costs credits.

29 endpoints

  1. POST /v1/brands/{brand_id}/seo/competitor-domains Add a competitor site
  2. DELETE /v1/brands/{brand_id}/seo/competitor-domains/{domain} Remove a competitor site
  3. GET /v1/brands/{brand_id}/seo/domains/{domain}/ranking-keywords List a site's ranking keywords
  4. POST /v1/brands/{brand_id}/seo/domains/{domain}/ranking-keywords/refreshes Load a site's ranking keywords
  5. GET /v1/brands/{brand_id}/seo/keyword-clusters List keyword clusters
  6. POST /v1/brands/{brand_id}/seo/keyword-clusters/recomputes Rebuild keyword clusters
  7. POST /v1/brands/{brand_id}/seo/keyword-clusters/serp-checks Check SERPs to group keywords
  8. GET /v1/brands/{brand_id}/seo/keyword-gap Get the keyword gap
  9. POST /v1/brands/{brand_id}/seo/keyword-gap/refreshes Refresh the keyword gap
  10. POST /v1/brands/{brand_id}/seo/keyword-research Research keywords
  11. GET /v1/brands/{brand_id}/seo/keywords List the keyword library
  12. POST /v1/brands/{brand_id}/seo/keywords Track keywords
  13. DELETE /v1/brands/{brand_id}/seo/keywords Stop tracking several keywords
  14. PATCH /v1/brands/{brand_id}/seo/keywords/{keyword_id} Update a tracked keyword
  15. DELETE /v1/brands/{brand_id}/seo/keywords/{keyword_id} Stop tracking a keyword
  16. GET /v1/brands/{brand_id}/seo/keywords/{keyword_id}/history Get a keyword's rank history
  17. GET /v1/brands/{brand_id}/seo/keywords/{keyword_id}/prompts List the AI prompts behind a keyword
  18. GET /v1/brands/{brand_id}/seo/keywords/candidates List keyword candidates
  19. POST /v1/brands/{brand_id}/seo/keywords/metric-refreshes Refresh keyword numbers
  20. POST /v1/brands/{brand_id}/seo/keywords/rank-checks Check Google positions
  21. PATCH /v1/brands/{brand_id}/seo/keywords/tracking Turn rank tracking on or off
  22. GET /v1/brands/{brand_id}/seo/overview Get the Google overview
  23. POST /v1/brands/{brand_id}/seo/overview/refreshes Refresh the Google overview
  24. GET /v1/brands/{brand_id}/seo/prompt-insights Get prompt insights for a report
  25. PUT /v1/brands/{brand_id}/seo/prompt-insights/keyword Pin the keyword a prompt stands for
  26. POST /v1/brands/{brand_id}/seo/prompt-insights/lookups Look up prompt insights
  27. GET /v1/brands/{brand_id}/seo/rank-schedule Get the rank check schedule
  28. PUT /v1/brands/{brand_id}/seo/rank-schedule Set the rank check schedule
  29. POST /v1/brands/{brand_id}/seo/serp-snapshots Read a keyword's Google page