Skip to main content
POST
/
brand-report
Brand Report
curl --request POST \
  --url https://app.mentionpilot.ai/api/v1/brand-report \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "brand_id": 1,
  "date": {
    "from": "2026-01-01",
    "to": "2026-05-07"
  },
  "ai_agent": [
    "chatgpt",
    "gemini"
  ]
}
'
{
  "success": true,
  "brand": "MentionPilot",
  "total_responses": 120,
  "visibility": 72,
  "sentiment": 80,
  "position": 2.5
}

Documentation Index

Fetch the complete documentation index at: https://help.mentionpilot.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Report parameters

brand_id
integer
required

ID of the brand to report on

Example:

1

date
object

Optional date range filter.

ai_agent
string[]

Filter by AI agent(s). Omit to include all agents.

Example:
["chatgpt", "gemini"]

Response

Brand report

success
boolean
Example:

true

brand
string
Example:

"MentionPilot"

total_responses
integer

Total number of AI responses analyzed

Example:

120

visibility
integer

Average visibility across all prompts (0–100)

Example:

72

sentiment
integer

Average sentiment score across all prompts (0–100)

Example:

80

position
number

Average brand position across all prompts

Example:

2.5