Token costs
Every billable request consumes tokens. The cost is fixed per endpoint and
identical whether you call it over the REST API or as an
MCP tool. Each response reports its exact cost in the
X-Tokens-Used header.
Per-endpoint cost
Section titled “Per-endpoint cost”| Endpoint | MCP tool | Token cost |
|---|---|---|
| Market stats | get_market_stats | 10 |
| Property details | get_property | 10 |
| AI comp value | get_property_ai_comp_value | 10 |
| Property search | search_properties | 10 |
| Parcel filter | filter_properties | 30 |
| Comps | list_comps | 1 per returned comp |
| Skip trace by property | skip_trace_property_owner | 20 per matched trace |
| Skip trace by name | skip_trace_owner | 20 per matched trace |
| Saved markets — list | list_saved_markets | 0 |
| Saved markets — save | save_market | 0 |
| Saved markets — remove | unsave_market | 0 |
| Usage | get_usage | 0 |
| Usage breakdown | get_usage_breakdown | 0 |
The zero-cost rule
Section titled “The zero-cost rule”Empty results and errors cost 0 tokens. A search that matches nothing, a
404, a validation error, or a rate-limit 429 all report X-Tokens-Used: 0.
For list_comps, cost scales with the
number of comps actually returned — a page of 50 comps costs 50 tokens, an empty
page costs 0.
The skip trace tools (skip_trace_property_owner
and skip_trace_owner)
follow the same rule: a trace that finds no contact information returns
matched: false and costs 0 tokens — you only pay the 20 tokens when contact
information is found.
Dollar pricing and tiers
Section titled “Dollar pricing and tiers”This page covers token costs, not dollars. How many tokens your API add-on includes, overage rates, and plan pricing live in the Land Insights app:
- Plans & billing — your subscription, API add-on, included tokens, and pricing.
To see tokens you’ve already spent this period, use the free usage endpoints.