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. Advanced search supports criteria in Clay’s field catalog as well as cross-entity filters, such as people at companies matching firmographics, and nested Boolean logic. You fetch the query reference, write a query, create a search, and page through results.

Advanced search

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

​
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.