Developer · API reference

Visibility

How often your brand shows up in AI answers, versus competitors.

Visibility measures how often your brand appears in AI-search answers across the prompts you track. These endpoints return the scores, leaderboards and per-provider breakdowns behind the Results page.

Most take a POST body describing the company, date range and grouping (segment, offering, location, provider). The `-combined` variants return the leaderboard and the chart series in one call.

POST /analytics/visibility-metrics

Get Visibility Metrics

Get visibility metrics with flexible filtering and grouping

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· VisibilityQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`filters`	object	No	—
`group_by`	string[]	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/visibility-metrics" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Returns a JSON object on success.

POST /analytics/visibility-combined

Get Combined Visibility Metrics

Get combined visibility metrics: top 10 leaderboard + top 7 chart history in one query

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· VisibilityQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`filters`	object	No	—
`group_by`	string[]	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/visibility-combined" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Field	Type	Notes
`success`	boolean	—
`message`	string	—
`conversationId`	string \| null	—
`data`	object \| null	—

POST /analytics/company-leaderboard

Get Company Leaderboard

Get company leaderboard for dashboard display

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· VisibilityQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`filters`	object	No	—
`group_by`	string[]	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/company-leaderboard" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Returns a JSON object on success.

POST /analytics/source-leaderboard

Get Source Leaderboard

Get source leaderboard for dashboard display

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· VisibilityQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`filters`	object	No	—
`group_by`	string[]	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/source-leaderboard" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Returns a JSON object on success.

POST /analytics/provider-performance

Get Provider Performance

Get AI provider performance metrics for dashboard display

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· VisibilityQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`filters`	object	No	—
`group_by`	string[]	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/provider-performance" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Returns a JSON object on success.

POST /analytics/competitor-domain-metrics

Get Competitor Domain Metrics

Fast per-domain visibility + sentiment for the /competitors page. Returns one row per domain (customer + competitors) straight off the daily CAGGs — NOT a ranked top-N, so no domain the page renders gets squeezed out by a leaderboard `limit`. Optional filters.company_domain narrows the scan.

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· VisibilityQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`filters`	object	No	—
`group_by`	string[]	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/competitor-domain-metrics" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Returns a JSON object on success.