AgentSEO

AgentSEO API

API for agent-ready SEO data extraction, analysis, and async job processing.

Developer tools#development

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

API for agent-ready SEO data extraction, analysis, and async job processing.

Endpoints 58

  • POSTSearch/search
  • POSTExtract content/extract
  • POSTAnalyze SERP/analyze/serp
  • POSTLocal listing audit (AEO starter)/audit/localAudits one business listing using its name and location. Domains, website URLs, and page URLs are not business names and are rejected before charging. The…
  • POSTBatch local audit/audit/local/batchEach item requires a business name and location. The entire batch is validated before any job or debit is created.
  • POSTContent gap/content/gap
  • POSTContent refresh brief/content/refresh-briefCreate an implementation-ready refresh plan for an existing URL and keyword. Costs 12 credits.
  • POSTSERP outline/content/serp-outlineTurn live SERP intent into a writer- and agent-ready page outline. Costs 4 credits.
  • POSTContent brief/content/briefTurn live SERP intent into a production-ready content brief for writers and agents. Costs 6 credits.
  • POSTContent draft QA/content/draft-qaValidate a draft URL or markdown against live SERP expectations before publishing. Costs 8 credits.
  • POSTContent schema plan/content/schema-planPlan JSON-LD schema for a URL or markdown page without a paid provider call. Costs 3 credits.
  • POSTContent internal links/content/internal-linksFind internal link opportunities from a source URL or markdown page to supplied target pages. Costs 2 credits.
  • POSTContent title and meta/content/title-metaGenerate SEO title and meta description options for a URL or markdown page. Costs 2 credits.
  • POSTContent technical publish QA/content/technical-qaRun pre-publish technical SEO QA for a URL, HTML page, or markdown draft. Costs 2 credits and does not call a paid SERP provider.
  • POSTContent keyword map/content/keyword-mapMap supplied keywords to supplied pages and flag weak matches, missing pages, and cannibalization risks. Costs 2 credits.
  • POSTContent action plan/content/action-planTurn supplied SEO opportunities into a capacity-aware content calendar and execution plan. Costs 2 credits and does not call a paid SERP provider.
  • POSTContent cannibalization detector/content/cannibalizationDetect pages that may compete for the same keyword intent and recommend safe consolidation, differentiation, canonical, internal-link, or monitoring actions.…
  • POSTCompetitor content gap matrix/content/competitor-gap-matrixCompare supplied own and competitor pages to find missing topics, weak coverage, format gaps, and buyer-stage gaps. Costs 3 credits and does not call a paid…
  • POSTSitemap and orphan-page audit/site/sitemap-auditAudit sitemap coverage, sitemap-only orphan candidates, important URLs, canonical/indexability noise, and internal-link gaps. Costs 2 credits and does not…
  • POSTSERP volatility monitor/serp/volatilityCompare supplied SERP snapshots to detect rank movement, top-domain churn, SERP feature changes, winners, losers, and target visibility movement. Costs 2…
  • POSTPage CRO and CTA QA/page/cro-qaAudit an SEO landing page for value proposition clarity, CTA strength, trust proof, objection handling, and conversion friction. Costs 2 credits and does not…
  • POSTProgrammatic SEO template planner/content/programmatic-templatePlan safe programmatic SEO templates before building pages at scale. Returns readiness score, scale risk, launch decision, template sections, uniqueness…
  • POSTAI visibility prompt-set builder/ai-visibility/prompt-setBuild a stable AI visibility prompt set mapped to platforms, competitors, owned assets, citations, and weekly action routing. Costs 2 credits and does not run…
  • POSTFind SEO opportunities/opportunities/findFind prioritized keyword and page opportunities for a domain or URL. Costs 3 credits base, plus 2 credits for SERP competitor enrichment and 2 credits for…
  • POSTOpportunity implementation brief/opportunities/briefTurn one selected keyword or page opportunity into an implementation-ready brief. Costs 10 credits base, or 12 credits with competitor outlines.
  • POSTWeb discussion discovery/social/listen
  • POSTAI overview extraction/ai-overview/extract
  • POSTLocal visibility tracking/local-visibility/track
  • POSTLLM mention tracking/llm-mentions/track
  • POSTContent decay detection/content-decay/detect
  • POSTKeyword cluster build/keyword-cluster/build
  • POSTKeyword ideas suggest/keyword-ideas/suggestExpand one seed keyword into prioritized long-tail keyword ideas with search metrics. Costs 4 credits.
  • POSTKeyword metrics overview/keyword-metrics/overviewScore a supplied keyword list with search metrics and page-priority guidance. Costs 5 credits per 25 keywords, minimum 5.
  • POSTDomain ranked keywords/domain/ranked-keywordsFind ranked keywords for a domain, subdomain, or URL and prioritize refresh opportunities. Costs 5 credits per 100 requested rows, minimum 5.
  • POSTDomain relevant pages/domain/relevant-pagesFind traffic-carrying pages for a domain and route them into protect, refresh, expand, recover, or review actions. Costs 5 credits per 100 requested pages,…
  • POSTDomain competitors/domain/competitorsDiscover search competitors for a domain and prioritize overlap, traffic gaps, threat level, and next analysis actions. Costs 5 credits per 100 requested…
  • POSTDomain intersection/domain/intersectionCompare two domains at keyword level and prioritize shared deficits, current advantages, and target1-exclusive opportunities. Costs 5 credits per 100…
  • POSTPage intersection/pages/intersectionCompare ranking pages to find shared page keywords or competitor-page keywords excluded from your pages. Costs 5 credits per 100 requested keywords, minimum…
  • POSTDomain traffic estimate/domain/traffic-estimateCompare estimated search traffic across multiple domains, subdomains, or URLs before spending deeper analysis credits. Costs 5 credits per 25 supplied…
  • POSTBacklinks summary/backlinks/summarySummarize backlink authority, referring domains, spam risk, broken backlinks, and next SEO actions for a domain, subdomain, or URL. Costs 5 credits.
  • POSTBacklinks list/backlinks/listReturn a bounded list of actionable backlinks and classify each one for authority protection, broken-target repair, lost-link reclaim, quality review, or…
  • POSTBacklinks anchors/backlinks/anchorsAnalyze backlink anchor text groups and classify branded, commercial, generic, URL, risky, broken, and lost anchor patterns. Costs 5 credits per 100 requested…
  • POSTBacklinks referring domains/backlinks/referring-domainsAnalyze referring domains and classify authority, lost-domain recovery, broken-link repair, quality review, and outreach patterns. Costs 5 credits per 100…
  • POSTBacklinks domain pages/backlinks/domain-pagesAnalyze backlink-bearing pages and classify linkable assets, broken backlink pages, lost links, refresh candidates, and quality risks. Costs 5 credits per 100…
  • POSTBacklinks competitors/backlinks/competitorsDiscover backlink-profile competitors and prioritize overlap, authority, and link-gap research actions. Costs 5 credits per 100 requested competitors, minimum…
  • POSTBacklinks new/lost timeseries/backlinks/new-lost-timeseriesTrack new and lost backlinks/referring domains over time and classify link momentum, leakage, volatility, or stability. Costs 5 credits.
  • POSTBacklinks page intersection/backlinks/page-intersectionFind source pages that link to competitor targets but not excluded/user targets and classify link-gap outreach opportunities. Costs 5 credits per 100…
  • POSTBacklinks opportunity finder/backlinks/opportunity-finderTurn supplied backlink prospects, competitor link-gap exports, and owned linkable assets into prioritized safe outreach, reclaim, repair, and digital PR…
  • GETRank history/rank/track?keyword=string&url=https://example.com
  • POSTQueue rank tracking/rank/track
  • GETGet job status/jobs/:id
  • GETStream job status updates/jobs/:id/events
  • GETList webhook endpoints/webhooks/endpoints
  • POSTCreate a webhook endpoint/webhooks/endpoints
  • DELETEDelete a webhook endpoint/webhooks/endpoints/:id
  • PATCHUpdate a webhook endpoint/webhooks/endpoints/:id
  • GETList webhook deliveries/webhooks/deliveries
  • POSTRetry a webhook delivery/webhooks/deliveries/:id/retry

API details

Base URL
https://www.agentseo.dev/api/v1
Authentication
An API key in the x-api-key header
Operations
58 operations on 55 pathsPOST 51GET 5PATCH 1DELETE 1
Response formats
application/json text/event-stream
Description format
OpenAPI 3.1.0, API version 0.1.0

How to test the AgentSEO API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the AgentSEO API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the x-api-key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Search” (POST /search), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the AgentSEO API?

API for agent-ready SEO data extraction, analysis, and async job processing. It is listed under Developer tools and has 58 endpoints.

Who publishes the AgentSEO API?

It is listed from AgentSEO's public API description (an OpenAPI document), not published by AgentSEO on Swastik Codes. Anyone who controls agentseo.dev can claim the profile by adding a DNS TXT record.

What is the base URL of the AgentSEO API?

Requests go to https://www.agentseo.dev/api/v1. Endpoint paths are added to this base URL.

How do I authenticate with the AgentSEO API?

With an API key in the x-api-key header.

How many endpoints does the AgentSEO API have?

58 operations on 55 paths (51 POST, 5 GET, 1 PATCH, 1 DELETE).

Is forking the AgentSEO API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.