Developer Access

Developer APIs

Access root-ready base files, AI execution SEO reports, sitemaps, robots.txt, per-page JSON-LD headers, job status, GEO audits, and search-engine submission workflows programmatically.

The developer flow is built for repeatable implementation: crawl a site, export the Base files ZIP, hand the SEO report to an AI coding IDE with the target codebase open, then verify the root files and submit provider-specific discovery signals. API tokens can be scoped per environment so production, staging, plugins, and custom integrations do not need to share credentials.

Generate API Token Download Agent

Base Files ZIP

Root-ready sitemap.xml, robots.txt, llms.txt, seodb-site.json, and the AI execution SEO report.

GET /v1/api/download/web-base-files?url=https://example.com

AI SEO Report

HTML report with an AI Execution Directive, per-page tasks, metadata fixes, JSON-LD blocks, and audit acceptance criteria.

GET /v1/api/download/seo-report?url=https://example.com

Page JSON-LD Header

Per-page JSON-LD schema with Organization and Article/WebPage types.

GET /v1/api/site/example.com/about/header
Authorization: Bearer seodb_...

Endpoint Reference

# Public site APIs, requires API token from /tokens/
GET /v1/api/site/example.com/sitemap
GET /v1/api/site/example.com/robots
GET /v1/api/site/example.com/about-us/header

# Download generated files, available in dashboard
GET /v1/api/download/web-base-files?url=https://yoursite.com
GET /v1/api/download/seo-report?url=https://yoursite.com
GET /v1/api/download/robots?url=https://yoursite.com
GET /v1/api/download/jsonld-spec?url=https://yoursite.com

# Check job status
GET /v1/api/job-status/<job_id>

# GEO audit endpoints
POST /v1/api/geo/audit   {"url": "...", "categories": ["entity_clarity", ...]}
GET  /v1/api/geo/categories
GET  /v1/api/geo/audit/{id}/category/{key}

# Search engine submissions
GET  /v1/api/search-engines/status
POST /v1/api/search-engines/websites/<website_id>/submit
POST /v1/api/search-engines/submit-all

Authentication

Send tokens as bearer credentials. Create separate tokens per environment or integration.

Authorization: Bearer seodb_...

Typical Integration

Generate a token, crawl the site, then let your plugin or external system request sitemap, robots, and JSON-LD output from SEOdb.

SEOdb Agent

Use the generic drop-in script for quick setup, or call the agent snippet endpoint directly when you need a site-specific install block. The dashboard keeps Base files and SEO reports separate from the agent so implementation tasks can be handled by your IDE, CMS, plugin, or deployment workflow of choice.

Download Agent

SEOdb Agent Install Snippet

Paste to auto-apply fixes in page before </head>

<script
  async
  src="https://seodb.org/dist/seodb-agent-1.0.10.js"
  data-api-base="https://www.seodb.org"
  data-token="seodb_REPLACE_WITH_TOKEN"
  data-observe-mutations="true">
</script>

WordPress Plugin JS Agent