API - Get Filters – SURFE

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.

A note on the Technologies filter

Most filters return a simple list of values. The technologies filter is slightly different — it returns as an object with two fields:

name — the name of the technology (e.g. "Salesforce")
categories — a list of categories that technology belongs to

So when using technologies as a filter in your search, make sure you're referencing the name value rather than the full object.

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.

Additional Resources