Match modes & combination logic
Every text filter accepts a mode that controls how your search terms are matched:

• SMART (default) — Uses AI to find related concepts, not just the words you typed. Searching for creative director will also find people with titles like art director or head of creative. Use SMART to expand your reach when the exact wording varies.
• WORD — Finds the exact phrase but allows extra words around it. creative director will match associate creative director or group creative director, but not art director. Use WORD when the phrase must appear literally.
• STRICT — The most restrictive mode: only the exact characters you typed. creative director returns only creative director — no variations, prefixes, or suffixes. Use STRICT for precise, deduplicated targeting.

any vs all

• any = OR logic — a record matches if it matches at least one of the values. Adding more values expands your results.
• all = AND logic — a record matches only if it matches every value. Adding more values narrows your results.

Both accept include and exclude. A search cannot consist of exclude filters only.

Value limits

• Maximum 300 values per include/exclude array.
• Maximum 10,000 results per search (100 per page). To retrieve more than 10,000 — e.g. a search matching 38,000 people — use the Lists pagination pattern: pull the first 10,000, add their ids to a list via POST /v1/lists (free), re-run the same search with "lists": { "people_id": { "exclude": ["<list-id>"] } } — now only 28,000 remain — pull the next 10,000, append to the list, and repeat until you have all 38,000.

Match modes & combination logic
Every text filter accepts a mode that controls how your search terms are matched:

• SMART (default) — Uses AI to find related concepts, not just the words you typed. Searching for creative director will also find people with titles like art director or head of creative. Use SMART to expand your reach when the exact wording varies.
• WORD — Finds the exact phrase but allows extra words around it. creative director will match associate creative director or group creative director, but not art director. Use WORD when the phrase must appear literally.
• STRICT — The most restrictive mode: only the exact characters you typed. creative director returns only creative director — no variations, prefixes, or suffixes. Use STRICT for precise, deduplicated targeting.

any vs all

• any = OR logic — a record matches if it matches at least one of the values. Adding more values expands your results.
• all = AND logic — a record matches only if it matches every value. Adding more values narrows your results.

Both accept include and exclude. A search cannot consist of exclude filters only.

Value limits

• Maximum 300 values per include/exclude array.
• Maximum 10,000 results per search (100 per page). To retrieve more than 10,000 — e.g. a search matching 38,000 people — use the Lists pagination pattern: pull the first 10,000, add their ids to a list via POST /v1/lists (free), re-run the same search with "lists": { "people_id": { "exclude": ["<list-id>"] } } — now only 28,000 remain — pull the next 10,000, append to the list, and repeat until you have all 38,000.

Reference exclusion lists created via POST /v1/lists (free): { "people_id": { "exclude": ["<list-id>"] } } on people endpoints, { "company_id": { "exclude": ["<list-id>"] } } on Company Search. Up to 10 lists per request, each holding up to 10,000 items. Standard uses: suppress already-contacted prospects, and paginate beyond the 10,000-result cap.