Search new restaurants, unlock leads and pull the ones you own into your CRM or your own tools. The API uses the same credits, prices and rules as the website.
Base URL: https://dinetracer.com/api/v1. Requests and responses are JSON.
Send your key in the Authorization header:
curl https://dinetracer.com/api/v1/account \ -H "Authorization: Bearer dt_live_your_key_here"
# response {"ok": true, "email": "[email protected]", "credits": {"balance": 12845, "plan": 10345, "bought": 2500}, "plan": {"name": "Scale", "credits_per_month": 30000, "status": "active", "renews_at": "2026-11-18T10:00:00", "cancelling": false}, "pricing": {"credits_per_lead": 25, "usd_per_credit": "0.02"}}
| Method | Path | What it does | Cost |
|---|---|---|---|
| GET | /api/v1/account | Your email, credits (plan vs bought) and plan | Free |
| GET | /api/v1/leads | Search the Restaurant Database. Previews are masked until you own the lead | Free |
| GET | /api/v1/leads/{id} | One record: the preview, or every detail once you own it | Free |
| POST | /api/v1/leads/{id}/unlock | Unlock one record and get its details | 25 credits ($0.50); free if you own it |
| GET | /api/v1/leads/owned | Every lead you own, across lead types, newest first | Free |
| GET | /api/v1/leads/updates | What changed on the leads you own in the last 30 days | Free |
| GET | /api/v1/monitors | Your Monitors | Free |
GET /api/v1/leads takes the same filters as the Restaurants list:
state: a 2-letter code, such as TXq: a name, city, address or 5-digit ZIP (at least 3 characters)signal: the license type, such as full (on-premise liquor) or beer_winefreshness_days: only records first seen in the last N days, such as 30contact: any, phone or website, to keep records we have contact details forview: new (the default: records you don’t own yet), owned or allpage: the page number, from 1curl "https://dinetracer.com/api/v1/leads?state=TX&q=austin&freshness_days=30" \ -H "Authorization: Bearer dt_live_your_key_here"
Each lead has an id (use it to unlock or open the record), name (partly hidden until you
own the lead), city, state, category, signal, discovered_at,
what contact details are available (has_phone, has_website, has_owner_contact)
and owned. The response also has total, page, pages and
new_to_unlock.
Unlocking a lead costs 25 credits ($0.50). A lead you already own is free, every time. Send a JSON body;
add an idempotency_key so a retry never charges twice.
curl -X POST https://dinetracer.com/api/v1/leads/LEAD_ID/unlock \
-H "Authorization: Bearer dt_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"idempotency_key": "crm-sync-2026-10-18-001"}'
The response has the full record, what was charged and your new balance.
Leads you unlock through the API show up on the website too, and the other way round.
required,
balance, shortfall).Content-Type: application/json.Retry-After header.Limits are per account and shared with the website: 600 requests an hour, and 300 searches an hour.