Usage and credits

Semantil keeps plans, balances, and current credit units in the product services. This documentation deliberately does not duplicate a price list.

Current sources of truth

• Pricing publishes current plans and commercial terms.
• GET /api/products publishes the current data products, fields, bundles, and credit units.
• GET /api/me returns the authenticated account’s current plan, balance, and API capabilities.

Charging behavior

Domain enrichment is result-based: a selected product is charged only when it passes its quality gate and returns data. Missing domains and products that do not return data are not charged.

Cap a request before it runs

Read the current units from GET /api/products, then pass max_credits on a domain enrichment request. Semantil rejects the request before lookup when the selected products could exceed the limit.

GET /api/domains/example.com?products=profile,tech&max_credits={limit}

Responses expose the charged amount and remaining balance in credit headers, so integrations do not need a copied price table to track usage.