Person Segment Query
Retrieve MixRank person IDs matching a combination of features, such as industry or country. Obtain filter IDs from <a href="#tag/audience-segments/GET/segment-features/{segment}">feature lookup</a>; feature IDs are filter values, not person IDs. Use comma for AND, | for OR, ~ for NOT and parentheses for grouping. ~(123,456)|789 matches records lacking at least one of 123 and 456, or possessing 789. Queries accept at most 530 features.
Returns a token for an asynchronous export of up to 10,000 IDs. Poll <a href="#tag/audience-segments/GET/segment-result">the export result</a> with that token: 204 means pending, 200 downloads Zstandard-compressed CSV containing one row of sorted IDs. Empty output is the literal none. A _truncated suffix before .csv.zst indicates additional matches. Exports can only be downloaded by the submitting user.
Required permissions for your API key's user: persons.segment.query.
Request
- Base URLhttps://api.mixrank.com/v2/json/YOUR_API_KEY
- Authnone declared
Request body application/x-www-form-urlencoded
Response
Successful response.
Example response
{
"token": "a2e1f8c3d7b9e2d6f1e8b0a5c2d3f4b6"
}Changes
No recorded changes to this operation across all 1 revision of this API.