Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blitz-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

Field Normalization

Accepted values for industry, employee range, job level, job function, company type, sales region, and country codes. All values are case-sensitive.
Agents & LLMs: a Markdown version of this page is available by appending .md to the URL, and the full documentation index is at llms.txt.
BlitzAPI Search endpoints (Company Search, Employee Finder, Find People, Waterfall ICP) use normalized values for categorical filters. Passing an incorrect value (e.g., "SaaS" instead of "Software Development") will silently return 0 results.
All enum values are case-sensitive and must match exactly. Copy-paste from the linked pages to avoid typos.

Sections

This reference is split across the following pages so each is small enough to load fast and easy to copy from:

Keyword Filters

include / exclude keyword search behavior, exact-match brackets, and the visual diagram of how branches and exclusions combine.

Industry

The full list of 534 accepted industry values for company.industry.include and company.industry.exclude.

Job Levels & Functions

people.job_level enum (C-Team, VP, Director, …) and the 22-value people.job_function enum.

Companies

company.type enum (10 values) and company.employee_range headcount buckets.

Geography

Sales regions, continents, and country codes (ISO 3166-1 alpha-2) for location filters.

LinkedIn URLs

Accepted LinkedIn URL formats and what BlitzAPI normalizes for you.

Troubleshooting: 0 Results

The most common cause is a non-normalized value. Check these:
  • Industry: "Tech" is not valid — use "Information Technology and Services" or "Computer Software" or "Internet".
  • Country code: "USA" is not valid — use "US". "United Kingdom" is not valid — use "GB".
  • Employee range: "50-200" is not valid — use "51-200".
  • Job level: "vp" is not valid — use "VP". "C-Level" is not valid — use "C-Team".
  • Job function: "Sales" is not valid — use "Sales & Business Development".
  • Sales region: "NA" is not valid — use "NORAM".
All values are case-sensitive. Copy-paste from the linked pages.
LinkedIn’s industry taxonomy is granular. Try using multiple values in your industry.include array to broaden the search. For example, instead of just "Computer Software", also include "Information Technology and Services" and "Internet".
Check that you’re using the right combination of job_level and job_function. For example, to find senior sales leaders, use "job_level": ["C-Team", "VP", "Director"] combined with "job_function": ["Sales & Business Development"].
The most common cause is a case-sensitive enum mismatch in company.industry, people.job_function, or people.job_level. Copy values from these pages exactly.Other checks:
  • Make sure at least one of company or people is provided.
  • Avoid over-filtering: combining a narrow industry, a small employee_range bucket, and a strict hq.country_code will quickly empty the result set.
  • For person geography, set people.location.country_code (not company.hq.country_code) — those are independent filters.
Find People uses cursor-based pagination (not page-based). Pass the cursor value from the previous response back into the next request and stop when the API returns cursor: null. Do not assume total_results / max_results — use the cursor as the source of truth.