get/api/v2/llm-mentions

List LLM Mentions aggregate intelligence rows.

Returns project-scoped LLM Mentions market intelligence. This documents provider-derived aggregate evidence, not raw response-level mentions; provider provenance remains available in response fields.

Requires bearer API key

Parameters

X-Project-Id

header

Required for organization-wide API keys on project-scoped endpoints. Project-scoped keys infer the project automatically.

Schema: string

limit

query

No description provided.

Schema: integer

Responses

200

Successful JSON response.

application/json
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "brandName": {
            "type": "string"
          },
          "relation": {
            "type": "string"
          },
          "isMyBrand": {
            "type": "boolean"
          },
          "domain": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "mentionCount": {
            "type": "integer"
          },
          "visibilityShare": {
            "type": "number"
          },
          "rank": {
            "type": "integer",
            "nullable": true
          },
          "sourceType": {
            "type": "string",
            "nullable": true
          },
          "contentType": {
            "type": "string",
            "nullable": true
          },
          "evidenceType": {
            "type": "string",
            "enum": [
              "provider_aggregate_intelligence"
            ]
          },
          "provider": {
            "type": "string",
            "enum": [
              "dataforseo"
            ]
          },
          "surface": {
            "type": "string",
            "enum": [
              "llm_mentions"
            ]
          },
          "sourceMode": {
            "type": "string"
          },
          "query": {
            "type": "string",
            "nullable": true
          },
          "providerRunId": {
            "type": "string",
            "nullable": true
          },
          "lastSeenAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "brandName",
          "relation",
          "isMyBrand",
          "domain",
          "url",
          "title",
          "mentionCount",
          "visibilityShare",
          "rank",
          "sourceType",
          "contentType",
          "evidenceType",
          "provider",
          "surface",
          "sourceMode",
          "query",
          "providerRunId",
          "lastSeenAt"
        ]
      }
    },
    "total": {
      "type": "integer"
    },
    "page": {
      "type": "integer"
    },
    "size": {
      "type": "integer"
    },
    "totalPages": {
      "type": "integer"
    }
  },
  "required": [
    "items",
    "total",
    "page",
    "size",
    "totalPages"
  ]
}

Try it

Send this request to the local WatchLLM REST handler. Use a key from `/workspace/api`; organization keys can include `X-Project-Id` only when the endpoint documents that header.