Skip to main content
Searches let you find companies and people in Clay’s GTM database, then fetch structured records to use in your application, workflow, or agent.

​
Choose a search mode

Use advanced search (beta) by default. It supports criteria in Clay’s field catalog as well as cross-entity filters, such as people at companies matching firmographics, and nested Boolean logic. Use structured filters (filters mode) if you prefer its older structure or have existing filters-mode searches. You discover the available fields, send a JSON filters object, and page through results.

Advanced search (beta)

Write Clay search queries with cross-entity criteria and nested Boolean logic.

Structured filters

Discover available fields, then search with a JSON filters object.

​
Result limits

Clay caps how many search results a workspace can return through the API. These limits apply to results returned across the CLI and Public API, and they scale with your plan.
  • Per request is the largest limit you can request in a single call.
  • Per search is the total results you can fetch across all pages of one search_id.
  • Reset date is when the period limit resets.
When you exceed a limit, Clay returns HTTP 402 with a message naming the limit you hit. Period-limit errors also state when the limit resets. Malformed filters or other invalid input still return HTTP 400. To increase a limit, paid customers can contact Clay Support; Enterprise customers should contact their assigned Clay GTME.

Quickstart

Set up your API key.

Generated API reference

See the create-search schema and try-it UI.

Run a search, then enrich with a function

Combine Searches with Clay-managed functions.