POST/v2/live/discover/people/advanced/count

Count advanced discover search results

Returns the count of persons matching complex criteria with and/or/not semantics organized by index (vendorgraphics, company, workExperience)

Version
v2
Rate limit
Tier 2 · 10–100 rps by plan
Billing
Discover · Count advanced discover search results

Request body

  • companyobjectOptional
    Filters for company index (firmographic data)
  • cursorstringOptional
    Pagination cursor from previous response for fetching next page of results
  • limitinteger (int32)Optional
    Maximum number of results to return per page (default: 1000, max: 1000)
  • metadataobjectOptional
    Optional metadata to associate with the request. Will be returned in the response.
  • personobjectOptional
    Filters for person attributes (location)
  • vendorgraphicsobjectOptional
    Filters for vendorgraphics index (products and categories)
  • workExperienceobjectOptional
    Filters for work experience index (job titles, roles, etc.)
  • groupingobjectOptional
    Result diversity controls
Headers
x-api-key Required · API key for authentication

Response

  • countinteger (int64)
    Number of matching persons for the given search criteria
  • hasProblemsboolean
    Whether we hit a problem answering the request: the profile or company wasn't found, or a data source failed or timed out. Data may be missing or incomplete; problems, where the response has it, says which.
  • isRetryableboolean
    When isSuccess is false, whether sending the same input again could succeed. Always true when isSuccess is true.
  • isSuccessboolean
    true when the request was answered with a result. false means no result was returned: check isRetryable, which is true when a data source failed or timed out and false when the input matched nothing.
  • metadataobject
    Caller-supplied metadata echoed back from the request.

Status codes