When building searches with Surfe’s API, you might need to know what filters are available, like industries, countries, departments, or seniorities.
That’s where the People Filters endpoint comes in.
This article explains how to use this endpoint to retrieve the full list of supported filter values so your system always stays aligned with what Surfe supports.
Why Use Filters?
Surfe’s API is powerful, but it’s even more useful when combined with structured filters like:
Departments (e.g. Sales, Marketing, HR)
Seniority levels (e.g. Manager, Director, VP)
Industries (e.g. Software, Retail)
Technologies used by a company
Company sizes (by employee count or revenue)
The Endpoint You’ll Use
To get the most current list of available filters, use the People Filters endpoint.
This is a simple GET request. No body or parameters needed. Just include your API token!
Example Request
curl --location 'https://api.surfe.com/v1/people/search/filters' \
--header 'Authorization: Bearer YOUR_API_TOKEN'
Replace YOUR_API_TOKEN with your actual Surfe API key. Here’s how to find it.
Example Response (snippet of response)
{
"filters": {
"employeeCounts": [
"0-1",
"2-10",
"11-50",
"51-200",
"201-500",
"501-1000",
"1001-5000",
"5001-10000",
"10001-50000",
"50001-100000",
"100001-500000",
"500000+"
],
"revenues": [
"0-1M",
"1-10M",
"10-50M",
"50-100M",
"100-500M",
"500-1000M",
">1000M"
],
"industries": [
"3D Printing",
"3D Technology",
"Accounting",
"Ad Network",
"Adult",
"Advanced Materials",
"Adventure Travel",
"Advertising",
"Advertising Platforms",
"Advice",
"Aerospace",
"Affiliate Marketing",
"Agriculture",
"AgTech",When to Use It
Use the People Filters endpoint when you need to:
Build or update People Search requests with valid filter options.
Accepted filters for Company Search Endpoints.
Which endpoints use filters?
Summary
This endpoint provides the latest available filters for People Search.
Ensures your filters match what Surfe supports.
Helps prevent errors and improves the search experience by keeping your filters accurate.
Need Help?
If you have any questions or need further assistance, feel free to reach out to our support team via Intercom.