Developers

Nositeo API

Count leads, buy lists with your credits and pull the records into your CRM. Every request uses an API key from your dashboard.

Authentication

Send the key in the Authorization header. Keys start with nos_, are shown once when created, and can be revoked at any time. Each key allows 60 requests per minute; the X-RateLimit-Remaining header shows what is left, and going over returns 429 with Retry-After.

curl https://nositeo.tech/api/v1/account -H "Authorization: Bearer nos_your_key"

{ "organization": { "name": "Acme Web Studio" }, "credits": 2500 }

Filters

The same filters as the website, as query parameters (GET) or JSON fields (POST). All are optional.

Field	Values
trade	roofing, solar, hvac, plumber, electrician, restoration, pest, garage, landscaping, concrete, painting, fencing, remodel, flooring, windows, tree, paving, pool, deck, gutters
region	A country (US, GB, CA, AU, AE, NZ, SA, QA) or country and metro, for example US:Dallas or GB:London
website	no_site, has_site, none, dead, live
fit	A, B (A only, or A and B)

Count leads

Free. Shows about how many match, how many you already own and about how many are new. matched and new are rounded down (2,431 becomes 2,400; 1 to 9 becomes 1, meaning under 10). The order response gives the exact number of leads delivered.

curl "https://nositeo.tech/api/v1/leads/count?trade=roofing&region=US:Dallas&website=no_site" \
  -H "Authorization: Bearer nos_your_key"

{ "matched": 50, "owned": 20, "new": 30, "rounded": true, "filter": { "trade": "roofing", "country": "US", "metro": "Dallas", "website": "no_site" } }

Place an order

Spends one credit per lead you do not own yet, best fit first, up to 50,000 leads per order. max_credits is required as a safety cap: the order is refused (409) if it would cost more. Without enough credits you get 402. Set include_owned to true to also include leads you already own, at no cost.

curl -X POST https://nositeo.tech/api/v1/orders \
  -H "Authorization: Bearer nos_your_key" -H "Content-Type: application/json" \
  -d '{ "trade": "roofing", "region": "US:Dallas", "website": "no_site", "quantity": 25, "max_credits": 25 }'

{ "order": { "id": 42, "leads": 25, "credits_spent": 25, "leads_url": "/api/v1/orders/42", "download_url": "/api/v1/orders/42/download?format=csv", ... } }

Get the leads

As JSON, 500 per page (follow next_page), or as a CSV or Excel file. Both can be fetched again at any time and always carry the latest data.

curl "https://nositeo.tech/api/v1/orders/42?page=1" -H "Authorization: Bearer nos_your_key"
curl -o leads.csv "https://nositeo.tech/api/v1/orders/42/download?format=csv" -H "Authorization: Bearer nos_your_key"

{ "page": 1, "pages": 1, "next_page": null, "leads": [ { "id": 4119, "name": "...", "phone_e164": "+1817...",
  "website_state": "dead", "street_address": "...", "city": "Dallas", "metro": "Dallas", "b2b_fit_score": 93, "last_verified": "Oct 2026", ... } ] }

GET /orders lists your orders. Data last verified Oct 2026.

Errors

Every error has the same shape. Codes: 400 invalid request, 401 missing or revoked key, 402 not enough credits, 404 not found, 409 order refused, 429 rate limited, 500 our fault.

{ "error": { "code": "insufficient_credits", "message": "Not enough credits for this order." } }