Developer · API reference
Citations
The URLs AI models cite when they mention you or your competitors.
Citations are the source links AI models rely on in their answers. These reads return your own cited pages, per-citation detail, and the citations your competitors earn — the evidence behind authority and gap analysis.
/analytics/all-citations/{company_id}Get All Citations
Get all source pages that cite the customer, with rich metadata. Returns citations grouped by company type (You, Competitor, Third Party). Includes readability metrics, page type, mentioned companies/products.
🔒 Requires Authorization: Bearer ll_… (or X-API-Key).
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_id | string | Yes | — |
Query parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
time_frame_days | integer | No | 30 | — |
organization_type | SourceType | null | No | — | — |
page_type | WebpageType | null | No | — | — |
publisher_type | RelationshipType[] | null | No | — | — |
limit | integer | No | 100 | — |
offset | integer | No | 0 | — |
Example request
curl -X GET "https://api.lunalift.ai/analytics/all-citations/COMPANY_ID" \
-H "Authorization: Bearer ll_your_api_key"Response · 200 OK
Returns a JSON object on success.
/analytics/citation-detail/{company_id}/{page_hash}Get Citation Detail
Returns alignment scores and top prompts for a single citation (on-demand, opened from dialog). Alignment score per mentioned company = their citation count on this page / total citation count of this page within the time window. Keyed by slim_company.id to match page_mention.entity_id already on the frontend.
🔒 Requires Authorization: Bearer ll_… (or X-API-Key).
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_id | string | Yes | — |
page_hash | integer | Yes | — |
Query parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
time_frame_days | integer | No | 30 | — |
Example request
curl -X GET "https://api.lunalift.ai/analytics/citation-detail/COMPANY_ID/PAGE_HASH" \
-H "Authorization: Bearer ll_your_api_key"Response · 200 OK
Returns a JSON object on success.
/analytics/competitor-citations/{company_id}Get Competitor Citations
Get top competitors by total citation count, with their top cited pages. Shows competitor summary metrics and their most cited URLs with page metrics.
🔒 Requires Authorization: Bearer ll_… (or X-API-Key).
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_id | string | Yes | — |
Query parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
time_frame_days | integer | No | 30 | — |
limit_competitors | integer | No | 10 | — |
limit_pages_per_competitor | integer | No | 5 | — |
Example request
curl -X GET "https://api.lunalift.ai/analytics/competitor-citations/COMPANY_ID" \
-H "Authorization: Bearer ll_your_api_key"Response · 200 OK
Returns a JSON object on success.
/analytics/competitor-citation-pages/{company_id}Get Competitor Citation Pages
Return ALL citation pages (source_domain, page_hash, citations, page_scores, page_type) for a specific competitor domain, so the frontend can compute: - exact internal vs external citation totals (adds up to total_citations) - weighted-average content quality / EEAT / structure / technical scores - citation breakdown by page type
🔒 Requires Authorization: Bearer ll_… (or X-API-Key).
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_id | string | Yes | — |
Query parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
competitor_domain | string | No | — | |
time_frame_days | integer | No | 30 | — |
Example request
curl -X GET "https://api.lunalift.ai/analytics/competitor-citation-pages/COMPANY_ID" \
-H "Authorization: Bearer ll_your_api_key"Response · 200 OK
Returns a JSON object on success.
/analytics/competitor-citations-daily/{company_id}Get Competitor Citations Daily
Get daily citation counts per competitor domain (and the customer company) for time-series charts. Returns one row per (domain, day).
🔒 Requires Authorization: Bearer ll_… (or X-API-Key).
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_id | string | Yes | — |
Query parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
time_frame_days | integer | No | 90 | — |
Example request
curl -X GET "https://api.lunalift.ai/analytics/competitor-citations-daily/COMPANY_ID" \
-H "Authorization: Bearer ll_your_api_key"Response · 200 OK
Returns a JSON object on success.
/analytics/competitor-prompt-mentions/{company_id}Get Competitor Prompt Mentions
Return top prompts and topics for a competitor domain, ranked by mention count, using the prompt_daily_company_metrics continuous aggregate.
🔒 Requires Authorization: Bearer ll_… (or X-API-Key).
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_id | string | Yes | — |
Query parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
competitor_domain | string | No | — | |
time_frame_days | integer | No | 30 | — |
limit | integer | No | 15 | — |
Example request
curl -X GET "https://api.lunalift.ai/analytics/competitor-prompt-mentions/COMPANY_ID" \
-H "Authorization: Bearer ll_your_api_key"Response · 200 OK
Returns a JSON object on success.