Skip to main content
POST
/
accounts
/
search
/
preview
Preview
curl --request POST \
  --url https://app.prontohq.com/api/v2/accounts/search/preview \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "included_industries": [
    "6",
    "96"
  ],
  "included_locations": [
    "103644278"
  ],
  "company_size": [
    "51-200",
    "201-500"
  ],
  "keyword": "saas"
}
'
{
  "total_count": 4321,
  "preview": [
    {
      "company_name": "Pronto",
      "industry": "Technology, Information and Internet",
      "linkedin_id": "104885158",
      "linkedin_url": "https://www.linkedin.com/company/104885158"
    }
  ]
}

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 /accounts/search and get back a synchronous preview: the total estimated account count plus the first 25 matching companies. Use it to validate filters and size an audience before kicking off the real search.

​
Overview

Compared to POST /accounts/search, the preview:
  • Does not create an import job.
  • 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 account search — see Search accounts by filters for the full reference (included_industries, excluded_industries, included_locations, excluded_locations, company_size, keyword, min_revenue, max_revenue, revenue_currency, …). webhook_url, name, limit, and streaming are accepted but ignored: the response always contains up to 25 accounts.

​
Rate Limits

  • 1 request per second per user/IP address.

​
Response

200 OK — returns immediately with: 
{
  "total_count": 4321,
  "preview": [
    {
      "company_name": "Pronto",
      "industry": "Technology, Information and Internet",
      "linkedin_id": "104885158",
      "linkedin_url": "https://www.linkedin.com/company/104885158"
    }
  ]
}
FieldTypeNotes
total_countintegerTotal estimated number of accounts matching the filters (not capped to 25).
previewarray of objectsUp to 25 matching accounts. Each entry contains the fields listed above when available.

​
Example

{
  "included_industries": ["6", "96"],
  "included_locations": ["103644278"],
  "company_size": ["51-200", "201-500"],
  "keyword": "saas"
}

Authorizations

​
X-API-KEY
string
header
required

Your API key

Body

application/json

Accepts the same filter object as POST /accounts/search (included_industries, excluded_industries, included_locations, excluded_locations, company_size, keyword, min_revenue, max_revenue, revenue_currency, etc.). webhook_url, name, limit, and streaming are accepted but ignored — the response is always the first 25 results.

Response

Preview generated successfully.

​
total_count
integer

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

​
preview
object[]

Up to 25 matching accounts.