Skip to main content
POST

​
Quick Answer

How do I find contacts in an industry by job title? Use Contact Prospect with NAICS codes and job titles. Minerva queues an asynchronous job and returns a job_id you poll until completion, then unlock to retrieve billed results.Common questions this endpoint answers:
  • How do I prospect contacts in specific NAICS industries?
  • How do I find title matches without providing a company list?
  • How do I safely retry a contact-prospect request?
What you need: One or more NAICS codes (2–6 digits) and one or more job titles with at least one meaningful alphanumeric token.What you get back: HTTP 202 with a job_id, job_type, status, and created_at. Poll Contact Job Status, then unlock via Contact Job Results.

​
Overview

Contact Prospect finds people whose current job falls under the NAICS industries you specify and whose titles approximately match the titles you request. NAICS codes are prefix-matched against stored 6-digit codes. For example, "51" matches information industries under that prefix. Note that a substantial share of current jobs have no NAICS code and are invisible to this filter. The endpoint is asynchronous — same lifecycle as Contact Append:
  1. Submit → 202 + job_id
  2. Poll status until completed
  3. Unlock results (billing) with POST .../results
  4. Page with GET .../results
Billing happens on unlock, not on submit. See Contact Job Results.

​
Request

​
Headers

​
x-api-key
string
required
Your API key for authentication.
​
Idempotency-Key
string
Optional client-supplied key (max 200 characters). Reusing the same key with the same org and an identical request returns the existing job. Reusing it with a different request body returns 409 Conflict.

​
Body

​
naics_codes
string[]
required
NAICS industry codes (1–10 entries). Each code must be 2–6 ASCII digits. Codes are prefix-matched against stored 6-digit NAICS values.
​
job_titles
string[]
required
Desired job titles (1–25). Titles are pre-filtered in SQL, then matched approximately. At least one title must contain a non-stopword alphanumeric token.
​
size
integer
Maximum contacts to return. Defaults to 100. Range: 1–500.

​
Response

​
Success Response (202 Accepted)

​
job_id
string
UUID of the queued job. Use it with Contact Job Status and Contact Job Results.
​
job_type
string
Always contact_prospect for this endpoint.
​
status
string
Initial status, typically queued.
​
created_at
string
ISO-8601 timestamp when the job was created.
Response Example

​
Errors