Skip to main content
v1.0GuidesGuidesAPI ReferenceAPI Reference

Brand Rankings

GET 
/resource/ai/entities
GEThttps://api2.sonalabs.com/resource/ai/entities

Retrieve your brand and its competitors as they appear in AI answers, with how often and how well each one is mentioned.

Only brands mentioned at least once in the range are returned. For each brand:

  • mentionCount: number of AI answers (rankings) that mention the brand.
  • visibility: mentionCount / totalRankings * 100.
  • shareOfVoice: the brand's share of all brand mentions in the range, in %.
  • positionScore: rank across all answers, combining every position the brand was listed at (1 = best). Brands tied on score share a rank.
  • sentimentScore: average sentiment of the mentions (0 when there is none). previousSentimentScore is the same for the period of equal length just before startDate.
  • isMain: your own brand. isWatched: a competitor you track.

When startDate is omitted, the range starts at the brand's first ranking. When endDate is omitted, it ends today.

Results are paginated. Use the offset and limit parameters to page through the full result set; the response includes the total count along with the offset and limit applied to the current page.

Calling this endpoint does not consume credits.

Request​

Responses​

Success