REST API

Plain HTTP and JSON for scripts, CRMs and data pipelines. A free account with a verified e-mail address is required.

Authentication

Create a key under API keys and send it in the Authorization: Bearer header of every request.

Examples

curl "https://larger.io/api/v1/domains/example.com?mode=quick" \
  -H "Authorization: Bearer YOUR_TOKEN"

Lookup modes

mode=quick (the default) fetches the site over HTTP and costs 5 tokens. mode=full also renders the page in a browser to catch technologies injected by JavaScript and costs 100 tokens, limited to 1 a minute per account across the REST API and MCP. A result less than 6 hours old is reused for 1 token.

Results carry mode, cached, scanned_at, the version of each technology when known, and emails as {email, type} objects.

Token costs

Operation	Tokens
Catalog	0
Technology details	1
Lookup, cached result	1
Quick lookup	5
Full lookup	100
Exports	0

Limits

2,000 tokens a month with a free verified account, shared by the REST API and the MCP server, reset on the 1st (UTC).

REST API: 60 requests a minute, 10 lookups a minute.
MCP server: 30 calls a minute, 3 lookups a minute.

Full lookups are limited to 1 a minute per account, shared by the REST API and the MCP server.

Token headers

Every counted response carries X-Tokens-Cost, X-Tokens-Remaining and X-Tokens-Limit.

Errors

Code	Meaning
`401`	The API key is missing or invalid.
`403`	The e-mail address is not verified, or the key has no read scope.
`404`	Unknown technology or category.
`422`	Invalid parameter, or the domain is flagged as dangerous.
`429`	Per-minute limit reached (see the Retry-After header), or the monthly token balance is spent (JSON body below).
`502`	The scan failed.
`504`	The site took too long to answer.

429 when the token balance is spent

{
    "message": "Not enough API tokens left this month: this request costs 5 and 3 remain. Your 2,000 tokens reset on 2026-11-01 (UTC).",
    "tokens_cost": 5,
    "tokens_remaining": 3,
    "tokens_limit": 2000,
    "resets_at": "2026-11-01T00:00:00+00:00"
}

Every endpoint and schema is in the OpenAPI reference.