Skip to main content
POST
/
leads
/
advanced_search
/
preview
Preview
curl --request POST \
  --url https://app.prontohq.com/api/v2/leads/advanced_search/preview \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "job_titles": [
    "VP of Sales",
    "Chief Revenue Officer"
  ],
  "seniority_levels": [
    "300",
    "310"
  ],
  "functions": [
    "25"
  ],
  "included_industries": [
    "96"
  ],
  "included_locations": [
    "101452733"
  ]
}
'
{
  "total_count": 1234,
  "preview": [
    {
      "full_name": "Ada Lovelace",
      "headline": "VP of Sales at Acme",
      "current_company": "Acme",
      "current_title": "VP of Sales",
      "linkedin_id": "104885158",
      "profile_url": "https://www.linkedin.com/in/urn:li:fs_salesProfile:(ACoAAAxxxx,NAME_SEARCH,abcde)"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.prontohq.com/llms.txt

Use this file to discover all available pages before exploring further.

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: 
{
  "total_count": 1234,
  "preview": [
    {
      "full_name": "Ada Lovelace",
      "headline": "VP of Sales at Acme",
      "current_company": "Acme",
      "current_title": "VP of Sales",
      "linkedin_id": "104885158",
      "profile_url": "https://www.linkedin.com/in/urn:li:fs_salesProfile:(ACoAAAxxxx,NAME_SEARCH,abcde)"
    }
  ]
}
FieldTypeNotes
total_countintegerTotal estimated number of leads matching the filters (not capped to 25).
previewarray of objectsUp to 25 matching leads. Each entry contains the fields listed above when available.

​
Errors

StatusWhen
400 Bad RequestNo filter or keyword provided.
401 UnauthorizedInvalid API key, or credentials missing/expired.
403 ForbiddenAPI key does not have access to this endpoint.
422 Unprocessable EntityInvalid filter shape, or enum ID outside the authorized list (e.g. unknown functions, seniority_levels, company_size, etc.).
429 Too Many RequestsPer-user rate limit (1 req/s) or upstream LinkedIn rate limit.

​
Example

{
  "job_titles": ["VP of Sales", "Chief Revenue Officer"],
  "seniority_levels": ["300", "310"],
  "functions": ["25"],
  "included_industries": ["96"],
  "included_locations": ["101452733"]
}

Authorizations

​
X-API-KEY
string
header
required

Your API key

Body

application/json

Same filter parameters as POST /leads/advanced_search. 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.