Skip to main content
Searches let your system discover GTM records without building a search UI or wiring directly into multiple data providers. Use advanced search (beta) by default: it supports criteria in Clay’s query reference, cross-entity filters, and nested Boolean logic. Use filters mode if you prefer its older structure or have existing filters-mode searches.

Example search intents

  • Find B2B SaaS companies in North America with more than 1,000 employees.
  • Find software engineers in New York City.
  • Find software companies with more than $250M in funding.

Advanced search also supports cross-entity criteria

Advanced search lets you return one entity based on attributes of a related entity.
  • Find sales leaders at high-growth software companies:
  • Find engineers at companies that use Salesforce:
  • Find companies that currently employ a VP of Sales:

How it works

Advanced search is a three-step iterator: fetch the query reference, create a search to receive a search_id, then fetch pages of results with that id. Filters mode follows the same iterator pattern, but starts by calling the fields endpoint.

Searches

Learn the search flow and copy a create-and-fetch example.