AI Ark
AI Ark provides people and company search, contact enrichment, and recruiting intelligence APIs.
Tools (19)
Analyze Personality
Infer DISC and OCEAN personality assessments plus selling and hiring outreach guidance from one person's LinkedIn profile. This costs 4 AI Ark credits per request and returns sensitive algorithmic inferences, not verified or objective facts.
Inputs: linkedin_url
Create or Update List
Create or mutate a temporary people/company exclusion list for free. Lists expire after 24 hours, hold at most 10,000 values, and are limited to 50 new lists per day. APPEND merges values; REPLACE irreversibly overwrites the complete prior list. Omitting list_id creates a list, and an unknown list_id can also create new state.
Inputs: mode, values, list_id, list_type
Enrich Person with Email
Enrich one person by AI Ark person ID or LinkedIn URL with a full profile and provider email-verification metadata. This returns sensitive personal profile and email data and is an enrichment action, not a standalone email verifier. It costs 1 credit only when a valid email is found and 0 credits otherwise.
Inputs: person_id, linkedin_url
Find Mobile Phone
Find candidate mobile phone numbers for one person from a LinkedIn URL or a company domain plus full name. AI Ark charges 5 credits per found phone number and 0 if none are found; the response contains sensitive personal numbers ordered by provider confidence.
Inputs: full_name, linkedin_url, company_domain
Get Credit Balance
Return the connected AI Ark account's remaining credit balance for free; this is the only action safe to use for credential validation.
Get Email Finder Status
Make one free status request for an email-finder job and return its state and total/found counts. This action does not poll internally or start another billable lookup; call it again only when another status check is needed.
Inputs: track_id
Get People Export Status
Make one free status request for a bulk people-export job and return its state, total/found/success/failed counts, and webhook metadata. This action does not poll internally; call it again only when another status snapshot is needed.
Inputs: track_id
List Email Finder Results
Return one free page of an email-finder job's results without waiting for completion. Entries still in PROCESSING state are preserved alongside completed entries. The response can contain sensitive personal email addresses, lookup inputs, and full provider verification and MX metadata.
Inputs: page, size, track_id
List Email Finder Submissions
Return one free page of the connected AI Ark customer's email-finder submission history, including job states and refund details. The provider automatically scopes results to the authenticated API key; callers control filters, repeated sort criteria, and pagination, and this action makes one request without polling or automatic pagination.
Inputs: page, size, sort, state, fully_refunded
List People Export Results
Return one free page of a completed bulk people export. The response contains sensitive full person and company profiles and personal emails with provider verification metadata. This action does not poll internally; a still-processing export returns 409, so check GET_PEOPLE_EXPORT_STATUS until its state is DONE before trying again.
Inputs: page, size, track_id
List People Export Submissions
List the authenticated API token's own people-export submission and refund history for free. Results are automatically scoped to the caller's customer account and this action returns one explicitly selected page without polling.
Inputs: page, size, sort, state, fully_refunded
Look Up Person by Email
Identify and return a sensitive, detailed personal and employment profile from an email address. AI Ark charges 0.5 credits per request, including when no profile is found. This action does not verify the input email and does not return a mobile number.
Inputs: email
Preview People
Return one page of masked people and full company matches for 1 credit per page. The preview contains no email or phone data and its trackId is null, so it cannot start email finding.
Inputs: page, size, lists, account, contact
Resend Email Finder Webhook
Resend an email-finder completion payload to a caller-selected public HTTPS webhook for free, potentially disclosing sensitive personal emails and lookup inputs; the destination may differ from the original submission. Success is reported only when AI Ark explicitly confirms delivery.
Inputs: track_id, webhook_url
Resend People Export Webhook
Irreversibly resend one completed bulk people export to a caller-selected public HTTPS webhook. This free action externally discloses sensitive full profiles and verified personal emails, may target a different URL from the original submission, and must not be retried after an ambiguous outcome. Success is reported only when AI Ark explicitly confirms delivery.
Inputs: track_id, webhook_url
Search Companies
Return one zero-based page of companies using typed company, employee, list, and lookalike filters, at 0.1 credits per returned company. Lookalike search accepts 1–5 domains or LinkedIn company URLs, page must be nonnegative, size 1–100, and up to 10,000 records are retrievable per search.
Inputs: page, size, lists, account, lookalike_domains
Search People
Return one page of full people and company profiles. This search costs 0.5 credits per returned person and does not return email addresses or phone numbers, but its personal and employment profile data is sensitive. The returned provider trackId (exposed as track_id) can be used once to start email finding and expires 6 hours after this search.
Inputs: page, size, lists, account, contact
Start Email Finder
Consume a People Search track ID exactly once, within 6 hours of the search, to start email finding. A required external HTTPS webhook receives sensitive personal email results. This costs 1 credit per valid email found and 0 credits for people without a valid email. Use GET_EMAIL_FINDER_STATUS to monitor the job and LIST_EMAIL_FINDER_RESULTS to retrieve partial or completed results.
Inputs: track_id, webhook_url
Start People Export
Irreversibly start one paid asynchronous export of up to 10,000 matching people and deliver full personal profiles with real-time verified emails to a required external HTTPS webhook. AI Ark charges 0.5 credits per exported person plus 0.5 credits per valid email found, so the explicit maximum charge is size credits. Do not retry an ambiguous outcome because a duplicate submission can incur another charge and external delivery.
Inputs: page, size, lists, account, contact, webhook_url