Token Cost
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 |
| Market stats by ZIP | get_zip_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 |
| Parcel image | get_parcel_image | 30 |
| Owner portfolio | find_owner_portfolio | 30 |
| Comps | list_comps | 1 per returned comp |
| Create comp report | create_comp_report | 0 |
| 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 |
| Deal flow listings | list_deal_flow_listings | 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. For what each plan costs, how many tokens it includes, and overage rates, see API Plans — and How to Upgrade Your API Plan when you’re ready to move up. You can manage your plan any time under Settings → API in the Land Insights app.
To see tokens you’ve already spent this period, use the free usage endpoints.