Contractor Data API — Free Counts, Previews and Pricing

Free API discovery — counts, previews, pricing

Every free endpoint below returns JSON with exact dataset counts, masked previews, and current pricing. No authentication and no payment is required for discovery.

• GET /api/v1/coverage — total records, live states, and latest verification date
• GET /api/v1/states · GET /api/v1/trades · GET /api/v1/cities — inventory discovery
• GET /api/v1/datasets — every purchasable dataset with record count and price
• GET /api/v1/datasets/{product_id} — product detail · /preview — masked rows · /price — current price

Machine-readable agent guides: /llms.txt · /llms-full.txt · /openapi.json.

Public browser-safe resources

The marketplace search asset and masked previews expose aggregate availability only. A limited teaser is available at /api/v1/texas-trades-teaser.json. It does not contain paid contact records.

API description

A production-safe OpenAPI description of the free discovery endpoints and live subscription API is available at /openapi.json.

Free agent discovery endpoints

Machine-readable dataset discovery is available under /api/v1/: coverage, states, trades, cities, datasets, product detail, and masked previews. Free endpoints expose metadata only and never paid contact values.

Catalog coverage by state

A factual, citation-ready reference for per-state catalog coverage is available at Coverage by State. The page reports catalog counts (not total market size) and points to the authoritative /api/v1/states JSON.

Production subscription API

TradeDataHub's production paid API is live. View API plans and checkout, save the API key shown after checkout, and send it as Authorization: Bearer YOUR_API_KEY.

• API Starter: $39/month · 5,000 contractor-row credits.
• API Agency: $99/month · 25,000 contractor-row credits.
• Credit unit: one contractor row returned = one API credit.
• Request size: up to 100 records per request.

Quickstart

curl "https://www.tradedatahub.net/api/access/v1/status" -H "Authorization: Bearer YOUR_API_KEY"

curl "https://www.tradedatahub.net/api/access/v1/datasets/PRODUCT_ID/records?limit=100&offset=0" -H "Authorization: Bearer YOUR_API_KEY"

Use free /api/v1/datasets discovery to obtain a product_id. See API Plans or interactive API docs.

Experimental x402 testnet retrieval

The separate x402 rail remains integration-test only on Base Sepolia (eip155:84532). Mainnet x402 settlement is not enabled.

Security

Paid records, download tokens, entitlements, customer data, and secrets are not published in discovery files.