Skip to main content
POST
Preview
Run the same filters as POST /leads/advanced_search and get back a synchronous preview: the total estimated profile count plus the first 25 matching leads. Use it to validate filters and size an audience before kicking off the real search.

Overview

Compared to POST /leads/advanced_search, the preview:
  • Does not create a Search record.
  • Does not call your webhook.
  • Does not consume credits.
  • Does not require webhook_url.
The body accepts the exact same filter parameters as the regular advanced search — see Search leads by filters for the full reference. webhook_url, name, limit, streaming, scale, and custom are accepted but ignored: the response always contains up to 25 leads.

Requirements

  • A valid integration must be connected on the authenticated user.
  • At least one filter or keyword must be provided.

Rate Limits

  • 1 request per second per user.

Response

200 OK — returns immediately with:

Errors

Example

Authorizations

X-API-KEY
string
header
required

Your API key

Body

application/json

Same filter parameters as POST /leads/advanced_search, including live (default true) to preview from Pipecorn's people database instead of LinkedIn Sales Navigator. webhook_url, name, limit, streaming, scale, and custom are accepted but ignored — the response is always the first 25 results.

Accepts the same filter object as POST /leads/advanced_search. See that endpoint for the full list of supported filters.

Response

Preview generated successfully.

total_count
integer

Estimated total number of leads matching the filters (not capped to 25).

preview
object[]

Up to 25 matching leads.