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
- Sign in at /portal/, open API, and click Create key (start with a Test key).
- Copy the key (we only show it once).
- Run this:
You’ll get JSON back with one sample lead. Swap in a live key to get your real leads.
Keys: test and live
ddk_test_…returns sample data and never changes anything. Safe for building and demos.ddk_live_…reads and writes your real account.- Send it as
Authorization: Bearer <key>. Keys are stored only as a one-way hash. Lost a key? Turn it off in the portal and make a new one.
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).
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.
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.
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.
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).
Errors and limits
- Errors look like
{"error":{"code":"unauthorized","message":"…"}}. 401bad key ·400bad input ·404unknown endpoint ·429more than 120 requests a minute per key.
Website pixel
Paste your line of code (from My Pixel in the portal) into the <head> of every page:
- WordPress: free “WPCode” plugin → Code Snippets → Header & Footer → paste in Header → Save.
- Shopify: Online Store → Themes → ⋯ → Edit code → theme.liquid → paste before
</head>→ Save. - Wix: Settings → Custom code → Add Custom Code → All pages, Head → Apply.
- Webflow: Site settings → Custom code → Head code → Save → Publish.
- Squarespace: Settings → Advanced → Code Injection → Header → Save.
- Google Tag Manager: New tag → Custom HTML → paste → trigger All Pages → Publish.
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