{
  "info": {
    "_postman_id": "2f4a9b4c-6b7e-4f90-9b33-8c1b0a1d9a21",
    "name": "MentionsAPI",
    "description": "One API for ChatGPT, Claude, Gemini, and Perplexity. Query all four in parallel, get structured brand mentions and deduplicated citations back. Set the `apiKey` collection variable before sending any request.\n\n- **Base URL:** `https://api.mentionsapi.com`\n- **Auth:** `Authorization: Bearer {{apiKey}}` on every endpoint\n- **Docs:** https://mentionsapi.com/docs\n- **OpenAPI:** https://mentionsapi.com/openapi.json",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mentionsapi.com",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "",
      "type": "string",
      "description": "Your MentionsAPI key. Create one in the dashboard (https://mentionsapi.com/app/keys)."
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "Ask",
      "description": "Multi-provider LLM fan-out with brand + citation extraction.",
      "item": [
        {
          "name": "POST /v1/ask \u2014 Multi-provider query",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"prompt\": \"Best PostgreSQL hosting providers in 2026?\",\n  \"providers\": [\"openai\", \"anthropic\", \"gemini\", \"perplexity\"],\n  \"track_brands\": [\"Supabase\", \"Neon\", \"Render\", \"Fly.io\"],\n  \"web_search\": true,\n  \"cache_scope\": \"shared\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/ask",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ask"
              ]
            },
            "description": "Fire a prompt at 1-4 LLMs. Returns normalized results with brand mentions and deduplicated citations. Use `mode: \"standard\"` for 30% cheaper async delivery or `async: true` with a `webhook_id` for push-based delivery."
          }
        },
        {
          "name": "POST /v1/ask \u2014 Multi-turn messages",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"messages\": [\n    { \"role\": \"system\", \"content\": \"Always answer as a concise analyst.\" },\n    { \"role\": \"user\", \"content\": \"Compare Supabase and Neon for serverless Postgres.\" }\n  ],\n  \"providers\": [\"openai\", \"anthropic\"],\n  \"params\": { \"temperature\": 0.3, \"max_tokens\": 800 }\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/ask",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ask"
              ]
            }
          }
        },
        {
          "name": "POST /v1/ask \u2014 Standard (async) mode",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"prompt\": \"What are the top AI SEO tools right now?\",\n  \"providers\": [\"openai\", \"anthropic\", \"gemini\", \"perplexity\"],\n  \"mode\": \"standard\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/ask",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ask"
              ]
            },
            "description": "Returns 202 with an `ask_id`. Poll GET /v1/ask/{id} until the status is `succeeded`. Credit is debited only on success."
          }
        },
        {
          "name": "GET /v1/ask/:id \u2014 Retrieve a past response",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/ask/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "ask",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "00000000-0000-0000-0000-000000000000",
                  "description": "Request id returned by POST /v1/ask."
                }
              ]
            },
            "description": "Responses are retained for 30 days. 202 = still processing, 200 = completed, 410 = expired."
          }
        }
      ]
    },
    {
      "name": "Extract Brands",
      "description": "Run the brand-extraction pipeline over arbitrary text.",
      "item": [
        {
          "name": "POST /v1/extract_brands",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"Supabase has emerged as a developer favorite, with Neon close behind. Render and Fly.io also get honorable mentions.\",\n  \"track_brands\": [\"Supabase\", \"Neon\", \"Render\", \"Fly.io\"],\n  \"source_provider\": \"unknown\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/extract_brands",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "extract_brands"
              ]
            }
          }
        }
      ]
    },
    {
      "name": "Mentions",
      "description": "Query the historical brand-mentions index and trigger on-demand crawls.",
      "item": [
        {
          "name": "GET /v1/mentions/search",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/mentions/search?brand=Supabase&limit=50",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "mentions",
                "search"
              ],
              "query": [
                {
                  "key": "brand",
                  "value": "Supabase"
                },
                {
                  "key": "provider",
                  "value": "openai",
                  "disabled": true
                },
                {
                  "key": "since",
                  "value": "2026-04-01T00:00:00Z",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50"
                }
              ]
            },
            "description": "Flat 10\u00a2 per query. Returns suggestions when no exact match is found."
          }
        },
        {
          "name": "POST /v1/mentions/crawl",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"brand\": \"Supabase\",\n  \"category\": \"database\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/mentions/crawl",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "mentions",
                "crawl"
              ]
            },
            "description": "Flat $2.00 on-demand crawl. Runs a 4-provider fan-out with web search ON, writes the extracted mentions into the brand_mentions table."
          }
        }
      ]
    },
    {
      "name": "Usage",
      "description": "Historical usage rollups for the calling account.",
      "item": [
        {
          "name": "GET /v1/usage \u2014 Daily report (last 30 days)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/usage?granularity=day",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "usage"
              ],
              "query": [
                {
                  "key": "start",
                  "value": "2026-04-01T00:00:00Z",
                  "disabled": true
                },
                {
                  "key": "end",
                  "value": "2026-04-30T23:59:59Z",
                  "disabled": true
                },
                {
                  "key": "granularity",
                  "value": "day"
                }
              ]
            }
          }
        }
      ]
    }
  ]
}