Developer · API reference

API reference

The LunaLift REST API gives you programmatic access to your own AI-search data — visibility, sentiment, citations, AI-traffic and the company profile behind them — plus the operations that drive the platform. Every endpoint returns JSON and is scoped to a company you have access to.

Base URL

https://api.lunalift.ai

Authentication

Every request needs an app API key. Create one on the API keys settings page in the app; the key acts as its creating user and is scoped to your account. Send it on every request in either of two ways:

Keep keys server-side — they carry your account's access. Rotate or revoke them from the same settings page.

Finding your company ID

Most endpoints take a company_id. List the companies your key can access — and their IDs — with the check-in endpoint:

curl -X POST "https://api.lunalift.ai/user/user-checkin" \
  -H "Authorization: Bearer ll_your_api_key"

The response's companies[].company_id values are the IDs you pass to the endpoints below.

Errors

Reference by area

• Companies & business profile

  Read a company's profile, entity map, and update its tracked domain.

• Business entities

  Create, read, update and delete segments, offerings, locations and ideal customers.

• Visibility

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

• Sentiment

  The tone of how AI answers talk about your brand.

• Citations

  The URLs AI models cite when they mention you or your competitors.

• Traffic, bots & conversions

  AI-bot crawls of your pages, the visitors AI sends you, and AI-attributed conversions.

• Prompts

  Manage the tracked prompts LunaLift runs against AI-search providers.

• Competitors & relationships

  Manage a company's competitive graph and domain aliases.

• Website operations

  Trigger enrichment, recrawl pages, regenerate schema, and generate llms.txt.

• Reports

  Read and edit shareable analytics reports and white-label branding.