Clay Advanced Search Creation

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use Toolmu to create one Clay search from my request. First consult the Clay search guide and follow its steps, including asking one brief follow-up unless I tell you to skip questions. Do not ask me to write the search in a special format. If a requested filter is not supported, tell me and continue with the supported details; do not guess. If my request is not about finding companies or people, explain that this search is for companies or people and do not create one. Explain in plain language that this creates a search only and does not list the matching companies or people.

Task:
Find companies in [country or region] that work in [industry] and have at least [employee count] employees.

Paste into your connected AI's conversation.

Connection guide

Clay

Start an Advanced Search in Clay

Describe the companies or people you want to find in everyday language. The AI can prepare a Clay search; this step creates the search but does not return the companies or people it finds.

You receive

A successful creation can return a search identifier and a source label. In the company search shown below, `companies` identifies the company-search source. Your Agent can save these with your search criteria so you can continue with a separate results lookup.

Start with your task

Find companies in [country or region] that work in [industry] and have at least [employee count] employees.

What to know

A separate results lookup is needed before you can review matching records; creating the search alone does not establish that they are ready.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Search request`body`	`object`	Required	Required object containing the advanced query. Required fields `query`
Advanced query`body.query`	`string`	Required	Provide a nonempty advanced query. Use the current query reference to check field names and grammar. Minimum length `1`

View raw JSON

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "query"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "query": {
          "type": "string",
          "minLength": 1,
          "description": "An advanced search query, e.g. 'select from people where experiences.any(is_current = true and job_title is_similar_to (\"VP Sales\") and company.estimated_employee_count >= 500)'. Fetch the query reference first for the full field catalog and grammar."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

No fixed output contract is available. Field types reflect saved result evidence; individual responses can differ.

Result schema
Field / Path	Type	Meaning
Search identifier`result.search_id`	`string`	Identifier for this created search. Save it with the exact query for a separate supported results lookup; it is not a company or person identifier.
Search source`result.source_type`	`string`	A label describing the search source. In the company-domain example, companies identifies a company search.

Additional notes

Prepare and keep your query

Clay’s Search documentation describes choosing People or Companies and viewing the underlying query. Use the current query reference to check fields and grammar before creating a search.

If you try different criteria, keep each returned search identifier with the exact query that created it. This helps you distinguish the searches when arranging a later results lookup.

Start an Advanced Search in Clay

Start an Advanced Search in Clay

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Prepare and keep your query

Open your AI chat

Describe who you want to find

Know what this step does