Skip to main content
GET
Autocomplete Person Metadata
Provides metadata statistics. This endpoint returns aggregated counts of persons grouped by various attributes such as job titles, seniority levels, and other person-related classifications. Useful for understanding the composition of your lead database and building analytics dashboards.

Authentication

This endpoint requires authentication. The user must be signed in to access metadata.
This endpoint proxies requests to the persons search metadata API. Results are cached for 7 days to improve performance.

Request

integer
default:"25"
Number of metadata items to return per page.
integer
default:"0"
Zero-based page number for pagination.

Response

Returns an array of metadata items, each containing a key-value pair representing an attribute and its count.
PersonMetadataItem[]
Array of metadata key-value pairs.

Response Examples

Usage Examples

Get default metadata

Get first page with custom size

Paginate through metadata

Notes

  • Results are cached for 7 days to improve performance. The cache is shared across all users in the organization.
  • Unlike other autocomplete endpoints that return paginated objects with content, this endpoint returns a flat array of key-value pairs.
  • Use this endpoint to build analytics dashboards or to understand the distribution of persons by various attributes in your database.