Developer Access

Developer APIs

Access sitemaps, robots.txt, per-page JSON-LD headers, job status, GEO audits, and search-engine submission workflows programmatically.

Generate API Token Download Agent

Sitemap.xml

XML sitemap with priority, changefreq, and lastmod for all crawled pages.

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

robots.txt

GEO-optimized robots.txt with AI crawler directives.

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

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/sitemap?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 download the site-specific install snippet from a website row in the dashboard.

Download Agent

<script defer src="https://seodb.org/assets/jar/latest/seodb-agent-1.0.0.js"></script>