Developer · API reference

Companies & business profile

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

Every call in the LunaLift API is scoped to a company you have access to. Start with `POST /user/user-checkin` (see Getting started) to list your companies and their IDs, then use those IDs here.

These endpoints read the company profile and the entity map — the structured picture of the business LunaLift builds from your website and Knowledge Base.

GET /company/collection/{company_id}

Get Company Collection Endpoint

Get complete CompanyCollection directly from database

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

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Example request

curl -X GET "https://api.lunalift.ai/company/collection/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Returns a JSON object on success.

GET /company/entity-map/{company_id}

Get Entity Map

Get lightweight entity name mappings for dashboard display

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

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Example request

curl -X GET "https://api.lunalift.ai/company/entity-map/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

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

PUT /company/update-url/{company_id}

Update Company Url

Update a specific company's URL. On every successful URL change — first-time set or subsequent edit — fires ``domain_keyword_fetch_wf`` as a fire-and-forget Hatchet run. keyword enrichment lands in the ``keyword`` table so the topic-discovery step has context the moment Luna suggests topics. A failure to enqueue the workflow logs at WARN but does NOT fail the URL save — per sign-off, keyword fetch is best-effort.

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

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Example request

curl -X PUT "https://api.lunalift.ai/company/update-url/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Returns a JSON object on success.