Developer API

Build with theGeol.ai API

Programmatic access to AI visibility optimization. Analyze content, generate structured data formats, and automate your GEO workflow.

Request API AccessOpenAPI Spec

Get Started in Minutes

Three simple steps to integrate AI visibility optimization into your workflow

01

Get Your API Key

Sign up for a Professional or Scale plan and generate your API key from the dashboard.

02

Make Your First Call

Use our REST API to create projects, initiate scans, and retrieve optimization formats.

03

Set Up Webhooks

Configure webhooks to receive real-time notifications when scans complete.

Authentication

All API requests require Bearer token authentication

Authorization Header

Include this header in every API request

Header
Authorization: Bearer gai_xxxxxxxxxxxxxxxx

Security Best Practices

Store API keys in environment variables. Never commit them to version control or expose them in client-side code.

API Reference

Complete endpoint documentation for programmatic access

Base URL: https://api.geol.ai/v1

Projects

GET/projects
POST/projects
GET/projects/{id}
PUT/projects/{id}
DELETE/projects/{id}

Pages

GET/projects/{id}/pages
POST/projects/{id}/pages

Scans

POST/scans
GET/scans/{id}
GET/scans/{id}/formats
POST/scans/{id}/formats/regenerate

Webhooks

GET/webhooks
POST/webhooks
PUT/webhooks/{id}
DELETE/webhooks/{id}

Code Examples

Copy-paste examples to get started quickly

curl -X POST https://api.geol.ai/v1/scans \
  -H "Authorization: Bearer gai_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "proj_abc123",
    "url": "https://example.com/blog/post",
    "formats": ["json-ld", "llms-txt", "og-json"]
  }'

Rate Limits

Limits are enforced per API key and reset every minute

PROFESSIONAL300 RPM
  • Full API access
  • Webhook support
  • Priority support
SCALE1000 RPM
  • Everything in Professional
  • Higher concurrency
  • Dedicated support

Response Headers

X-RateLimit-Limit

Max requests per minute

X-RateLimit-Remaining

Requests remaining

X-RateLimit-Reset

Reset timestamp (Unix)

Ready to Integrate?

Upgrade to Professional or Scale tier to unlock full API access with higher rate limits and priority support.

View PricingContact Sales