Map a website#

POST /v1/map

Discover same-site URLs before choosing which pages to retrieve. Mapping returns links, not page content. A successful map costs one credit.

Parameter	Type	Default	Description
`url`	string	Required	Public website URL to discover from.
`limit`	integer	100	Maximum returned URLs, from 1 to 1000.
`sitemap`	string	include	include combines sitemap and page discovery; only uses sitemaps; skip uses page discovery.

curl -X POST https://api.luni.gg/v1/map \
  -H "Authorization: Bearer $LUNI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: map-site" \
  -d '{"url":"https://example.com","limit":100,"sitemap":"include"}'

{
  "success": true,
  "links": [
    {
      "url": "https://example.com/"
    }
  ],
  "operationId": "<operation-id>",
  "creditsUsed": 1
}

A discovered URL is a candidate, not a guarantee of accessible content. Fetch selected URLs with scrape, or use crawl to discover and retrieve within a page budget.