LLllmpulse
Competitors

List competitor suggestions

Changed on

The two lists of the Suggested tab of the Competitors page. basis=brands (default) returns the competing brands the AI discovery proposed that are not tracked or rejected yet, with the names it would match and, when counted, how many answers name it (mentions). basis=citations returns the domains AI answers cite most that are not your own or tracked yet, with how many answers cite each (citations). discovery tells whether a discovery run is still loading. Read-only: it never starts a discovery run, which the page starts from its Discover button. Add a suggestion with POST /competitors.

get/competitors/suggestions

Request

  • Base URL
    https://api.llmpulse.ai/api/v1
  • URL
    https://api.llmpulse.ai/api/v1/competitors/suggestions
  • Auth
    API key in header Authorization

Query parameters

project_idinteger required

Project ID

basis'brands' | 'citations'
querystring

Only suggestions whose brand name or domain contains this text

pageinteger
per_pageinteger
output'flat' | 'csv'

Rectangular output for BI tools (Tableau, Excel, Sheets, ELT). Omit for the default nested JSON. 'flat' returns the same metadata plus 'columns' and 'rows'; 'csv' returns those rows as text/csv. Errors are always returned as JSON.

Response

Paginated suggestions

project_idinteger required
pageinteger required
per_pageinteger required
totalinteger required

Rows matching the filters across every page

request_idstring required
basis'brands' | 'citations' required

Changes