{
  "info": {
    "name": "AEO Spotlight Public API",
    "_postman_id": "aeo-spotlight-public-api",
    "description": "Verifiable, explainable, permissioned AI visibility. Set baseUrl (default https://api.aeospotlight.com) and apiKey (aeo_live_...) collection variables.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "baseUrl", "value": "https://api.aeospotlight.com" },
    { "key": "apiKey", "value": "aeo_live_REPLACE_ME" },
    { "key": "jobId", "value": "" }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      { "key": "value", "value": "{{apiKey}}", "type": "string" },
      { "key": "key", "value": "X-API-Key", "type": "string" },
      { "key": "in", "value": "header", "type": "string" }
    ]
  },
  "item": [
    {
      "name": "Entitlements",
      "item": [
        { "name": "GET /me", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/me" } },
        { "name": "GET /me/credits", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/me/credits" } }
      ]
    },
    {
      "name": "Queries",
      "item": [
        { "name": "GET /queries", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/queries" } },
        {
          "name": "POST /queries/1/run",
          "request": {
            "method": "POST",
            "header": [{ "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }],
            "url": "{{baseUrl}}/api/v1/queries/1/run",
            "body": { "mode": "raw", "raw": "{}" }
          }
        }
      ]
    },
    {
      "name": "Citations",
      "item": [
        { "name": "GET /citations", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/citations?hasMention=true&pageSize=20" } },
        { "name": "GET /citations/{id}", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/citations/1" } }
      ]
    },
    {
      "name": "Gaps & Opportunities",
      "item": [
        { "name": "GET /gaps", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/gaps" } },
        { "name": "GET /opportunities", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/opportunities" } },
        {
          "name": "POST /gaps/detect",
          "request": {
            "method": "POST",
            "header": [{ "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }],
            "url": "{{baseUrl}}/api/v1/gaps/detect",
            "body": { "mode": "raw", "raw": "{}" }
          }
        },
        {
          "name": "POST /opportunities/{id}/generate-content",
          "request": {
            "method": "POST",
            "header": [{ "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }],
            "url": "{{baseUrl}}/api/v1/opportunities/opp-123/generate-content",
            "body": { "mode": "raw", "raw": "{ \"persona\": \"Professional & Authoritative\" }" }
          }
        },
        {
          "name": "POST /opportunities/{id}/publish (propose)",
          "request": {
            "method": "POST",
            "header": [{ "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }],
            "url": "{{baseUrl}}/api/v1/opportunities/opp-123/publish",
            "body": { "mode": "raw", "raw": "{ \"destinationId\": \"dest-1\", \"mode\": \"propose\" }" }
          }
        }
      ]
    },
    {
      "name": "Competitors",
      "item": [
        { "name": "GET /competitors", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/competitors" } }
      ]
    },
    {
      "name": "Jobs",
      "item": [
        { "name": "GET /jobs", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/jobs" } },
        { "name": "GET /jobs/{id}", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/jobs/{{jobId}}" } }
      ]
    },
    {
      "name": "Webhooks",
      "item": [
        {
          "name": "POST /webhooks",
          "request": {
            "method": "POST",
            "url": "{{baseUrl}}/api/v1/webhooks",
            "body": { "mode": "raw", "raw": "{ \"url\": \"https://yourapp.example.com/aeo-events\", \"events\": [\"execution.completed\", \"content.cited\"] }" }
          }
        },
        { "name": "GET /webhooks", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/webhooks" } }
      ]
    },
    {
      "name": "Public",
      "item": [
        {
          "name": "POST /brand-check",
          "request": {
            "method": "POST",
            "auth": { "type": "noauth" },
            "url": "{{baseUrl}}/api/v1/brand-check",
            "body": { "mode": "raw", "raw": "{ \"brandName\": \"Nike\", \"websiteUrl\": \"https://nike.com\", \"recaptchaToken\": \"...\" }" }
          }
        },
        { "name": "GET /llms.txt", "request": { "method": "GET", "auth": { "type": "noauth" }, "url": "{{baseUrl}}/llms.txt" } },
        { "name": "GET /openapi.json", "request": { "method": "GET", "auth": { "type": "noauth" }, "url": "{{baseUrl}}/openapi.json" } }
      ]
    }
  ]
}