Usage and credits
Semantil publishes plans, balances, fields and current credit units through the live API. This documentation deliberately does not duplicate a price list.
Current sources of truth
Section titled “Current sources of truth”- Pricing publishes current plans and commercial terms.
GET /api/fieldspublishes the current fields plus the record and lead billing units.GET /api/mereturns the authenticated account’s current plan, balance, and API capabilities.
Charging behavior
Section titled “Charging behavior”Billing has two units. A found approved first-party company record costs one
credit. With enrich=true, qualifying registry or business-contact evidence
costs four additional credits, but only when that evidence is found. A missing
domain costs zero. The optional include projection changes the response size,
not the record price.
Cap a request before it runs
Section titled “Cap a request before it runs”Read the current units from GET /api/fields, then pass max_credits on a
domain enrichment request. Semantil rejects the request before lookup when its
maximum possible charge exceeds the limit.
GET /api/domains/example.com?max_credits=1A paid account can explicitly request the optional lead add-on:
GET /api/domains/example.com?enrich=true&max_credits=5Responses expose a per-unit usage receipt plus the charged amount and remaining balance, so integrations do not need a copied price table to track usage.