get_competitor_rankings | SocialCRM API Docs

Get competitive intelligence rankings showing how your brand compares to competitors in AI visibility. Filterable by brand and AI platform.

Parameters

Parameter	Type	Required	Description
`brandId`	string	No	Filter to a specific brand (UUID or name). Omit for company-wide view.
`platform`	string	No	Filter to a specific AI platform (`"chatgpt"`, `"claude"`, `"gemini"`, `"perplexity"`)
`limit`	number	No	Maximum number of rankings to return (default: 50, max: 100)

Example Request

curl -X POST https://socialcrm.com/api/mcp-app \
  -H "Authorization: Bearer sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/call",
    "params": {
      "name": "get_competitor_rankings",
      "arguments": {
        "brandId": "Ace Auto Repair",
        "platform": "chatgpt",
        "limit": 10
      }
    }
  }'

Example Response

Parsed from result.content[0].text:

{
  "rankings": [
    {
      "brandName": "Ace Auto Repair",
      "score": 85,
      "rank": 1,
      "platform": "chatgpt",
      "changeDirection": "up"
    },
    {
      "brandName": "Dallas Auto Works",
      "score": 72,
      "rank": 2,
      "platform": "chatgpt",
      "changeDirection": "stable"
    }
  ],
  "shareOfVoice": null,
  "competitorCount": 2
}

Output Schema

Field	Type	Description
`rankings`	array	Array of ranking objects (see below)
`shareOfVoice`	object \| null	Share-of-voice breakdown (when available)
`competitorCount`	number	Total number of competitors in the result set

Each ranking object:

Field	Type	Description
`brandName`	string	Competitor or brand name
`score`	number	Visibility score
`rank`	number	Position in the ranking
`platform`	string \| null	AI platform for this ranking
`changeDirection`	string \| null	`"up"`, `"down"`, or `"stable"`

Notes

Rankings are ordered by rank (ascending).
Competitor data is generated from monitoring workflows. Run a competitive_scan workflow to refresh.
Use get_competitors to see which competitors are configured for a brand.