Search endpoint

These examples target the Search Profiles endpoint. The same query patterns apply to Search Companies — swap the field paths for companies.*.

Looking for a reference on AND/OR logic, exact phrase matching, or .raw vs. text fields? See the Query operators cheat sheet.

Basic patterns

Search for profiles with an email address

Retrieve up to 5 profiles with an email on record. Uses an exists query.

{
  "query": {
    "exists": {
      "field": "profile_info.emails"
    }
  },
  "limit": 5
}

Search for Data Science professionals (full text)

match performs a full-text search and may include adjacent titles.

{
  "query": {
    "match": {
      "profile_info.current_title": {
        "query": "data scientist",
        "operator": "AND"
      }
    }
  },
  "limit": 10
}

Exact-match search on a title

profile_info.current_title is mapped as both text and keyword. Use term against the .raw field for an exact match.

{
  "query": {
    "term": {
      "profile_info.current_title.raw": {
        "value": "Data Scientist"
      }
    }
  },
  "limit": 10
}

Restrict to network connections only

in_network_only: true returns only profiles connected to your team — ideal for warm outreach.

{
  "in_network_only": true,
  "limit": 100,
  "query": {
    "bool": {
      "must": [
        {
          "match": {
            "profile_info.job_title": "Product Manager"
          }
        }
      ],
      "filter": [
        {
          "term": {
            "profile_info.job_seniorities": "senior"
          }
        }
      ]
    }
  }
}

Combining conditions

Multiple `must` conditions

Find all software developers working at The Swarm.

{
  "query": {
    "bool": {
      "must": [
        {
          "match": {
            "profile_info.current_title": {
              "query": "software developer"
            }
          }
        },
        {
          "match": {
            "profile_info.current_company_name": {
              "query": "The Swarm"
            }
          }
        }
      ]
    }
  }
}

Range filter combined with a term filter

Profiles in the Information Technology and Services industry whose current job was updated in a date range.

{
  "query": {
    "bool": {
      "must": [
        {
          "range": {
            "profile_info.current_job_updated_at": {
              "gte": "2024-05-12",
              "lte": "2024-05-18"
            }
          }
        },
        {
          "term": {
            "profile_info.current_company_industry": {
              "value": "Information Technology and Services"
            }
          }
        }
      ]
    }
  }
}

Nested queries (work experience)

Profiles in the US who previously held a product role at Google

Uses a nested query against profile_info.experience and excludes current roles.

{
  "query": {
    "bool": {
      "must": [
        {
          "match": {
            "current_location": {
              "query": "United States"
            }
          }
        },
        {
          "nested": {
            "path": "profile_info.experience",
            "query": {
              "bool": {
                "must": [
                  {
                    "match": {
                      "profile_info.experience.company.name": {
                        "query": "Google"
                      }
                    }
                  },
                  {
                    "match": {
                      "profile_info.experience.title.name": {
                        "query": "Product"
                      }
                    }
                  },
                  {
                    "bool": {
                      "must_not": [
                        {
                          "exists": {
                            "field": "profile_info.experience.is_current"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          }
        }
      ]
    }
  }
}

Anyone who has ever worked at Google

{
  "query": {
    "nested": {
      "path": "profile_info.experience",
      "query": {
        "match": {
          "profile_info.experience.company.name.raw": {
            "query": "Google"
          }
        }
      }
    }
  }
}

Worked at Google in the past, not currently there

{
  "query": {
    "bool": {
      "must": [
        {
          "nested": {
            "path": "profile_info.experience",
            "query": {
              "match": {
                "profile_info.experience.company.name.raw": {
                  "query": "Google"
                }
              }
            }
          }
        }
      ],
      "must_not": [
        {
          "match": {
            "profile_info.job_company_name.raw": {
              "query": "Google"
            }
          }
        }
      ]
    }
  }
}

Recent job changes

For full coverage of querying job changes (promotions vs company moves, polling patterns), see Daily Job Changes.

{
  "query": {
    "bool": {
      "filter": [
        {
          "range": {
            "profile_info.current_job_updated_at": {
              "gte": "2025-06-01"
            }
          }
        }
      ]
    }
  }
}

Pagination

Search returns up to 1000 results per page. Use the pagination_token from the previous response to retrieve the next page.

{
  "query": {
    "exists": {
      "field": "profile_info.emails"
    }
  },
  "limit": 5,
  "pagination_token": "eyJzZWFyY2hfYWZ0ZXIiOlt7ImZpZWxkIjoiX3Njb3JlIiwidmFsdWUiOjF9LHsiZmllbGQiOiJwcm9maWxlX2luZm8uaWQiLCJ2YWx1ZSI6IjAwMDE2MTU4LWYyY2EtNDYzZC05YWEzLTIyOWZkMzk0ZWQ0MSJ9XX0="
}

See Pagination for full details.

Example queries

Sample data

Tools

Basic patterns

Search for profiles with an email address

Search for Data Science professionals (full text)

Exact-match search on a title

Restrict to network connections only

Combining conditions

Multiple `must` conditions

Range filter combined with a term filter

Nested queries (work experience)

Profiles in the US who previously held a product role at Google

Anyone who has ever worked at Google

Worked at Google in the past, not currently there

Recent job changes

​Basic patterns

​Search for profiles with an email address

​Search for Data Science professionals (full text)

​Exact-match search on a title

​Restrict to network connections only

​Combining conditions

​Multiple must conditions

​Range filter combined with a term filter

​Nested queries (work experience)

​Profiles in the US who previously held a product role at Google

​Anyone who has ever worked at Google

​Worked at Google in the past, not currently there

​Recent job changes

​Pagination

Basic patterns

Search for profiles with an email address

Search for Data Science professionals (full text)

Exact-match search on a title

Restrict to network connections only

Combining conditions

Multiple `must` conditions

Range filter combined with a term filter

Nested queries (work experience)

Profiles in the US who previously held a product role at Google

Anyone who has ever worked at Google

Worked at Google in the past, not currently there

Recent job changes

Pagination