Data Dudes

API & pixel docs

Everything you need to pull your leads into your own software, plus how to add the website pixel. All examples are copy-paste ready. Building with an AI coding tool? Point it at /llms.txt.

Quickstart: your first call in 30 seconds

  1. Sign in at /portal/, open API, and click Create key (start with a Test key).
  2. Copy the key (we only show it once).
  3. Run this:
curl https://datadudes.online/api/v1/leads \ -H "Authorization: Bearer ddk_test_YOUR_KEY"

You’ll get JSON back with one sample lead. Swap in a live key to get your real leads.

Keys: test and live

GET /api/v1/leads

Your delivered leads, oldest first, so syncing is easy. Query params: since (ISO time, only leads added after it), limit (1–500, default 100), cursor (from next_cursor).

curl "https://datadudes.online/api/v1/leads?since=2026-10-01T00:00:00Z&limit=100" \ -H "Authorization: Bearer ddk_live_YOUR_KEY"
{ "mode": "live", "data": [{ "id": "a1b2c-0", "name": "Jane Roe", "company": "Roe Roofing", "title": "Owner", "email": "jane@roeroofing.com", "phone": "(303) 555-0142", "city": "Denver", "state": "CO", "zip": "80204", "confidence": "High", "reason": "Matched via verified business email", "at": "2026-10-10T20:15:03.000Z" }], "count": 1, "total": 1, "next_cursor": null }

POST /api/v1/leads/{id}/status

Tell us what happened with a lead so your results (booked calls, wins, cost per booked call) stay true. status is one of new, contacted, booked, won, lost; value is the optional deal value in dollars.

curl -X POST https://datadudes.online/api/v1/leads/a1b2c-0/status \ -H "Authorization: Bearer ddk_live_YOUR_KEY" -H "Content-Type: application/json" \ -d '{"status":"won","value":8500}'

Live keys are on the Pro plan; test keys work on every plan and change nothing.

POST /api/v1/suppress

Add people to your do-not-contact list. They’re saved as one-way hashes and screened out of your future lead files.

curl -X POST https://datadudes.online/api/v1/suppress \ -H "Authorization: Bearer ddk_live_YOUR_KEY" -H "Content-Type: application/json" \ -d '{"emails":["optout@example.com"],"phones":["3035550199"]}'

POST /api/v1/append-request

Ask us to fill in missing phones or emails for records you already have. A Data Dude runs it and the results show up as new leads. No match means no data: we never guess.

curl -X POST https://datadudes.online/api/v1/append-request \ -H "Authorization: Bearer ddk_live_YOUR_KEY" -H "Content-Type: application/json" \ -d '{"want":["phone","email"],"records":[{"name":"Jane Roe","address":"990 Cherokee St","zip":"80204"}]}'

Returns 202 with {"id":"apr_…","status":"queued"}.

Webhooks

Turn on Webhook under Delivery and we POST new leads to your URL as JSON: {"event":"leads","count":N,"leads":[…]}. Test leads use "event":"test_lead". Verify the X-DD-Signature: sha256=<hex> header: HMAC-SHA256 of the raw body with your signing secret (shown under Delivery).

// Node.js const crypto = require('crypto'); const ok = req.headers['x-dd-signature'] === 'sha256=' + crypto.createHmac('sha256', process.env.DD_SECRET).update(rawBody).digest('hex');

Errors and limits

Website pixel

Paste your line of code (from My Pixel in the portal) into the <head> of every page:

<script async src="https://datadudes.online/px.js?id=px_YOUR_ID"></script>

The pixel sets no cookies, respects Global Privacy Control and Do Not Track, and records page, referrer, time and a rough city from the IP address (the IP itself isn’t stored). It does not identify people by itself; named leads come from Data Dudes matching.

Questions? (720) 964-0044 · rod@datadudes.online