AI Ark API
The raw mechanics behind AI Ark's search and export API: the base URL, the X-TOKEN header, and the exact JSON shapes each filter type expects. Documents the trap that silently returns unfiltered results, the trap that throws a misleading 401, and where the email address actually lives in an export payload. Built for anyone writing code against the API or debugging a search that isn't behaving.
Pipeline Playbooks · Open Source, MIT Licensed
Pure API reference for AI Ark's lead database: the three filter shapes, the 401 trap on company keywords, export polling, and the traps that quietly return wrong results.
When to use this
- Writing code against the AI Ark API
- Debugging a search returning unfiltered or zero results
- Hitting 401, 400, 409, or 429 responses
- Extracting emails from an export payload
What it covers
- Base URL, X-TOKEN auth header, and required Content-Type
- The three filter shapes: SearchMatch, AllAny, and Range
- The company-keyword "sources" shape that avoids a 401
- Why person-level keyword filters are unreliable
- The export flow: webhook, polling, and paging results
- Where the email address lives in the export payload
- Rate limits: 5 requests/second, 300/minute, 18,000/hour
- Gotchas: no free count endpoint, job_duration in months, silent zero-result typos
Install just this skill
Every skill folder is self-contained. Run this from your project root to pull just this one into .claude/skills/ai-ark-api/:
npx degit joelwylie7/cold-email-playbooks/.claude/skills/ai-ark-api .claude/skills/ai-ark-api
Want the whole system, not just one skill?
Related skills
AI Ark List Builder
Build a cold email lead list with AI Ark: precise targeting, a free preview, a mandatory back-page quality check, then a confirmed export before credits get spent.
List Hygiene
The mandatory final pass every lead list gets before it touches a sending tool: dedup, exclusion lists, and an automatic MX check that drops Mimecast and Barracuda domains.
Email Verification
Runs Kitt verification on lists you bring from elsewhere, and draws the hard line on the one mistake that costs money for nothing: re-verifying an already-verified AI Ark export.