Credit Costs

A call costs the entity base rate per record returned, plus the rate of any premium, indicator or enrichment field you explicitly ask for. Standard fields add nothing.

How it works

• Every call deducts (base rate for the entity + the rate of each premium / indicator / enrichment field you requested) × the number of records returned. Standard fields are covered by the base rate.
• `fields` shrinks the payload, not the bill — dropping standard fields changes nothing. It only lowers cost when the field you drop is a premium / indicator / enrichment one. Omit `fields` entirely and you pay the base rate alone.
• Aggregated endpoints (stats, trend, delta, top-by, pivot, points, market-report), search and reports are billed per CALL at a flat rate, not per record. The exact amount is echoed in `meta.creditCost` on every response.
• No field is restricted by plan today: any active key may request any field and is billed the credit cost below. Your monthly credit allowance is what differs between plans.
• Premium fields (AI descriptions, AVM valuation, enrichment) typically cost more than standard fields.
• Contact enrichment (POST /v1/enrichment/contacts) is billed 18 credits per delivered result and 0 on a no-match — you only pay when contacts actually come back.

Credit Costs

A call costs the entity base rate per record returned, plus the rate of any premium, indicator or enrichment field you explicitly ask for. Standard fields add nothing.

How it works

• Every call deducts (base rate for the entity + the rate of each premium / indicator / enrichment field you requested) × the number of records returned. Standard fields are covered by the base rate.
• `fields` shrinks the payload, not the bill — dropping standard fields changes nothing. It only lowers cost when the field you drop is a premium / indicator / enrichment one. Omit `fields` entirely and you pay the base rate alone.
• Aggregated endpoints (stats, trend, delta, top-by, pivot, points, market-report), search and reports are billed per CALL at a flat rate, not per record. The exact amount is echoed in `meta.creditCost` on every response.
• No field is restricted by plan today: any active key may request any field and is billed the credit cost below. Your monthly credit allowance is what differs between plans.
• Premium fields (AI descriptions, AVM valuation, enrichment) typically cost more than standard fields.
• Contact enrichment (POST /v1/enrichment/contacts) is billed 18 credits per delivered result and 0 on a no-match — you only pay when contacts actually come back.