Skip to main content
The Pipecorn REST API gives you programmatic access to the same data as the web app: search and extract leads, enrich companies and contacts, pull buying signals, and manage Sales Navigator lists. Every endpoint below is documented with its parameters, an interactive request builder, and example responses.
Synchronous single contact enrichment is the one endpoint on another host: POST https://api.pipecorn.com/v2/contacts/single_enrich. The same path on app.pipecorn.com/api/v2 is the asynchronous enrichment, which returns 200 with status: "pending" instead of the results.

​
Your first request

Check your credit balance and plan limits. This call is free and confirms your key works.
If the key is wrong you get a 401. See Credit and limit errors for the 402, 403, and 422 responses that metering can return.

​
Rate limits

Every endpoint has a per-minute request limit set by your plan, counted per user across all your API keys. Each endpoint group keeps its own counter. Responses under the limit tell you where you stand:
Go over it and you get a 429 Too Many Requests with a Retry-After header. Wait that many seconds before you retry. Endpoints that spend enrichment credits, and the status lookups you poll while an async job runs, don’t count against the plan limit. A few endpoints add a stricter limit on top of it, such as 1 request per second on POST /leads/advanced_search. See Rate limiting for the full list of exempt endpoints, the per-endpoint limits, and a retry example.

​
Endpoints

Leads (People)

Search people by title, seniority, location, and industry. Extract leads from a company or from Sales Navigator, and enrich a single person.

Accounts (Companies)

Search companies by firmographics, enrich a single account, and pull headcount by department, tech stack, and open job postings.

Waterfall Enrichment

Find verified business emails and phones through 20+ sources, one contact per request, with results on your webhook or synchronously.

Signals

Hiring, growth, lookalike companies, tech-stack search, new hires, job changes, and LinkedIn posts, comments, reactions, and engagers.

Searches

List, inspect, and delete the saved searches your extractions create.

Personas

Create, read, update, and delete the personas that define your ideal buyer profiles.

Lists

Create and update Sales Navigator lists and read their contents.

Alerts

List the signal trackings you created and the searches each run produced.

Miscellaneous

Credit balance and consumption, account information, location IDs, technology slugs, and AI job title suggestions.

​
Before you build

  • Main use cases walks through the three flows most integrations start with.
  • Authentication covers the header format and key management.
  • Credits vs limits explains which requests spend credits and which draw on plan quotas.
  • Prefer not to write HTTP calls? The CLI and the MCP server wrap this API.