API Reference

    Integrate AIRank data into your own applications and workflows.

    🚧 API Coming Soon

    We're building a REST API for programmatic access to your ranking data. Join the waitlist to be notified when it launches.

    Planned Endpoints

    Here's a preview of the API endpoints we're building:

    GET/v1/brands

    List all brands in your account

    Response

    {
  "brands": [
    {
      "id": "brand_123",
      "name": "Acme Inc",
      "domain": "acme.com",
      "visibility_score": 72
    }
  ]
}
    GET/v1/prompts

    List all prompts for a brand

    Response

    {
  "prompts": [
    {
      "id": "prompt_456",
      "text": "Best CRM software 2026",
      "brand_id": "brand_123",
      "last_run": "2026-01-26T10:00:00Z"
    }
  ]
}
    POST/v1/prompts/{id}/run

    Run a prompt across all AI engines

    Response

    {
  "run_id": "run_789",
  "status": "completed",
  "results": {
    "chatgpt": { "position": 1, "mentioned": true },
    "perplexity": { "position": 3, "mentioned": true },
    "gemini": { "position": null, "mentioned": false }
  }
}
    GET/v1/analytics

    Get visibility analytics over time

    Response

    {
  "period": "7d",
  "data": [
    { "date": "2026-01-20", "visibility_score": 68 },
    { "date": "2026-01-21", "visibility_score": 71 },
    { "date": "2026-01-22", "visibility_score": 72 }
  ]
}

    Authentication

    API requests will be authenticated using Bearer tokens. You'll be able to generate API keys from your dashboard settings.

    curl -X GET "https://api.airankapp.com/v1/brands" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"

    Rate Limits

    Free

    100

    requests/day

    Pro

    10,000

    requests/day

    Lifetime

    Unlimited

    requests/day

    Webhooks

    Configure webhooks to receive real-time notifications when:

    • A scheduled prompt run completes
    • Your visibility score changes significantly
    • A competitor overtakes your ranking
    • New citations are discovered