REST API v1

Integrate AI visibility
into your agency tools

Access your clients' projects, GEO scores and AI analysis results directly via our REST API. Automate your reports and integrate Geoptim into your stack.

API available · Bearer authentication · JSON · 5,000 req/day

Why use the Geoptim API?

Designed for agencies and freelancers managing multiple clients

Simple integration

Standard REST API with Bearer authentication. Compatible with any language or tool (PHP, Python, JS, Zapier, n8n…)

Real-time data

Access the latest GEO scores, AI analyses and recommendations for your clients directly in your dashboards.

Complete automation

Trigger analyses, retrieve results, and generate reports automatically within your workflows.

Planned features

What awaits you

Discover the features that will be available from the launch of our API.

AI Analysis

Launch AI perception analyses for any domain via our REST API.

POST /api/v1/analyze
Real-time results

Scores & Metrics

Retrieve AI visibility scores and all detailed metrics.

GET /api/v1/scores
Data History

Recommendations

Get personalized recommendations generated by our AI.

GET /api/v1/recommendations
Automatic prioritization

Webhooks

Receive real-time notifications on important changes.

Automatic alerts
Flexible Configuration

Competitive analysis

Compare your performance with your competitors via the API.

GET /api/v1/competitors
Automated benchmarking

Automated reports

Generate and retrieve detailed reports in JSON format.

POST /api/v1/reports
Multiple formats
Standardized format

Consistent and predictable
JSON responses

All our responses follow the same format with success, data, and meta-information including your quota usage.

  • Explicit error handling (401, 404, 429)
  • Remaining quota in each response
  • ISO 8601 timestamps with timezone
  • Explicit versioning (api_version: "v1")
{
  "success": true,
  "data": {
    "projects": [...],
    "total": 12
  },
  "meta": {
    "timestamp": "2026-02-03T...",
    "api_version": "v1",
    "usage": {
      "daily_used": 42,
      "daily_limit": 5000,
      "daily_remaining": 4958
    }
  }
}

Available on Premium & Business plans

API access is included in Premium and Business subscriptions. Create up to 10 tokens with 5,000 requests per day each.

10
Simultaneous tokens
5 000
Requests / day / token
Accessible projects

Use cases

What agencies do with the Geoptim API

Unified client dashboard

Display GEO scores for all your clients in your own agency dashboard, with your branding.

Automated reports

Automatically generate monthly PDF reports with Geoptim data for each client.

Score Alerts

Trigger Slack or email alerts when a client's GEO score exceeds or drops below a threshold.

No-code integration

Connect Geoptim to Zapier, Make (Integromat) or n8n for no-code automations.