{ "openapi": "3.1.0", "info": { "title": "BlitzAPI Reference", "version": "2.0.0", "description": "Welcome to the BlitzAPI Reference.\n\nUse this interactive documentation to explore and test every v2 endpoint. Authentication is required via the `x-api-key` header.\n\n**Base URL**: `https://api.blitz-api.ai`\n\n**Rate limit**: Your requests-per-second limit depends on your plan and applies per endpoint: 5 requests per second on the free trial, 10 on Start, 25 on Scale, custom on Build Your Infra. Each endpoint has its own independent budget, so different endpoints don't share the limit. Read your key's exact limit from `max_requests_per_seconds` on `GET /v2/account/key-info`.\n\n**Pricing**: Every plan opens every endpoint, within the plan's fair use policy (records per month). New accounts get 1,000 free records every month. Find Mobile & Direct Phone is not part of the trial. See [Plans & Pricing](/guide/concepts/pricing)." }, "servers": [ { "url": "https://api.blitz-api.ai", "description": "Production server" } ], "tags": [ { "name": "Account", "description": "API key info and health check." }, { "name": "Waterfall ICP Search", "description": "Priority-based cascade search: find the best-match contact at a company." }, { "name": "Employee Finder", "description": "Browse all employees at a single company with filters." }, { "name": "Company Search", "description": "Search companies by industry, size, location, and keywords." }, { "name": "Job Search", "description": "Search job postings by role, location, and company firmographics." }, { "name": "People Enrichment", "description": "Enrich contacts with verified emails, phones, and reverse lookups." }, { "name": "Company Enrichment", "description": "Enrich companies and resolve domain ↔ LinkedIn URL." }, { "name": "Utilities", "description": "Helper endpoints (current date/time)." }, { "name": "Changelog", "description": "Public feed of API changes: breaking changes, features, fixes, and announcements." } ], "paths": { "/v2/account/key-info": { "get": { "summary": "Get API Key Details", "description": "Check API key validity, remaining records, rate limit per endpoint, allowed endpoints, and active subscription plans.", "tags": [ "Account" ], "security": [ { "APIKey": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "valid": true, "id": "XXX", "records_remaining": 950, "next_reset_at": "2026-02-12T17:48:25.199Z", "max_requests_per_seconds": 5, "allowed_apis": [ "/search/waterfall-icp-keyword", "/enrichment/linkedin-to-domain", "/enrichment/email" ], "active_plans": [ { "name": "Startup Trial", "status": "active", "started_at": "2026-01-12T17:48:25.200Z" } ] } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } } } } }, "/v2/search/waterfall-icp-keyword": { "post": { "tags": [ "People Search" ], "security": [ { "APIKey": [] } ], "summary": "Waterfall ICP Search", "description": "Find the best decision-maker at a target company using a prioritized cascade hierarchy.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_linkedin_url", "cascade" ], "additionalProperties": false, "properties": { "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/openai" }, "cascade": { "type": "array", "description": "Ordered list of search tiers (1 to 10). Tier 1 fills `max_results` first. If it finds fewer people than `max_results`, the next tier fills the slots that are left, and so on, until `max_results` is reached or no tiers are left. People already found in an earlier tier are not returned twice.", "minItems": 1, "maxItems": 10, "items": { "type": "object", "required": [ "include_title" ], "additionalProperties": false, "properties": { "include_title": { "type": "array", "items": { "type": "string" }, "description": "Job title phrases to match, OR'd together (1 to 50). All words of a phrase must be in the title, in any order, as whole words, with no stemming or synonyms. Wrap a phrase in square brackets for an exact match. See [Keyword Filters](/guide/reference/normalization/filters).", "example": [ "Marketing Director", "Head Marketing", "Chief Marketing Officer" ], "minItems": 1, "maxItems": 50 }, "exclude_title": { "type": "array", "items": { "type": "string" }, "description": "Job title phrases that disqualify a person, with the same matching rules as `include_title` (up to 50). Also checked against the LinkedIn headline when `include_headline_search` is `true`.", "example": [ "assistant", "intern", "junior" ], "maxItems": 50 }, "location": { "type": "array", "items": { "type": "string", "minLength": 2 }, "description": "Country codes of the person (not the company headquarters). Use 'WORLD' or an empty list for no restriction (up to 50 values).", "default": [ "WORLD" ], "example": [ "WORLD" ], "maxItems": 50 }, "include_headline_search": { "type": "boolean", "description": "When true, also searches the LinkedIn headline (not the About section) in addition to the job title. The person must still hold a current role at the company.", "default": false, "example": false }, "include_active_jobs": { "default": true, "examples": [ true ], "description": "Search the current jobs of each person. The company and the title filters of this tier must hold in the same job. The matched job is returned in `experiences`, and `job_is_current` says whether it is current.", "type": "boolean" }, "include_past_jobs": { "default": false, "examples": [ false ], "description": "Also search the past jobs of each person. A person is returned once, with the matched job; a current job is preferred to a past one.", "type": "boolean" }, "is_recent_hire": { "default": false, "examples": [ false ], "description": "Only people whose job at the company started in the last 90 days, within this tier. It covers the jobs that include_active_jobs and include_past_jobs select (current jobs by default). The job must also match the title filters of this tier. A job with no start date never matches.", "type": "boolean" } } } }, "max_results": { "type": "number", "description": "Maximum number of results to return.", "default": 10, "example": 10, "minimum": 1, "maximum": 100 }, "profile_min_connections": { "type": "number", "description": "Minimum number of LinkedIn connections a profile must have to be returned.", "default": 0, "example": 0, "minimum": 0 } } }, "example": { "company_linkedin_url": "https://www.linkedin.com/company/openai", "cascade": [ { "include_title": [ "Marketing Director", "Head Marketing", "Chief Marketing Officer" ], "exclude_title": [ "assistant", "intern", "product", "junior" ], "location": [ "WORLD" ], "include_headline_search": false }, { "include_title": [ "Marketing Manager", "Head Growth", "Growth manager" ], "exclude_title": [ "junior", "assistant", "intern", "hacker" ], "location": [ "WORLD" ], "include_headline_search": false }, { "include_title": [ "Communication Director", "Brand Director", "Content Director" ], "exclude_title": [ "junior", "assistant", "intern", "UX", "UI", "Design" ], "location": [ "WORLD" ], "include_headline_search": false }, { "include_title": [ "Communication Manager", "Brand Manager", "Content Manager" ], "exclude_title": [ "junior", "assistant", "intern" ], "location": [ "WORLD" ], "include_headline_search": false }, { "include_title": [ "Communication", "marketing", "growth", "brand" ], "exclude_title": [ "junior", "assistant", "intern", "product" ], "location": [ "WORLD" ], "include_headline_search": true }, { "include_title": [ "CEO", "founder", "cofounder", "owner", "General Director" ], "exclude_title": [ "junior", "assistant", "intern" ], "location": [ "WORLD" ], "include_headline_search": false } ], "max_results": 10 } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "company_linkedin_url": { "type": "string" }, "max_results": { "type": "number" }, "results_length": { "type": "number" }, "results": { "type": "array", "items": { "type": "object", "properties": { "icp": { "type": "number", "description": "Index (1-based) of the cascade tier that matched this result." }, "ranking": { "type": "number", "description": "Overall rank of this result across all tiers." }, "person": { "type": "object", "properties": { "first_name": { "type": "string" }, "last_name": { "type": "string" }, "full_name": { "type": "string" }, "nickname": { "type": [ "string", "null" ] }, "civility_title": { "type": [ "string", "null" ] }, "headline": { "type": [ "string", "null" ], "description": "Built from the person's first position as \" | @\", not the free-text headline on the LinkedIn profile." }, "about_me": { "type": [ "string", "null" ] }, "location": { "type": "object", "properties": { "city": { "type": [ "string", "null" ] }, "state_code": { "type": [ "string", "null" ] }, "country_code": { "type": [ "string", "null" ] }, "continent": { "type": [ "string", "null" ] }, "postal_code": { "type": [ "string", "null" ] }, "street_address": { "type": [ "string", "null" ] } } }, "linkedin_url": { "type": "string" }, "connections_count": { "type": "number" }, "profile_picture_url": { "type": [ "string", "null" ], "description": "Always null. The field is kept in the response so existing clients do not break." }, "experiences": { "type": "array", "items": { "type": "object", "properties": { "company_name": { "type": [ "string", "null" ] }, "job_title": { "type": "string" }, "company_linkedin_url": { "type": "string" }, "company_linkedin_id": { "type": "string" }, "company_domain": { "type": "string" }, "job_description": { "type": [ "string", "null" ] }, "job_start_date": { "type": [ "string", "null" ], "format": "date" }, "job_end_date": { "type": [ "string", "null" ], "format": "date" }, "job_is_current": { "type": "boolean" }, "job_contract_type": { "type": [ "string", "null" ] }, "job_work_arrangement": { "type": [ "string", "null" ] }, "job_location": { "type": "object", "properties": { "city": { "type": [ "string", "null" ] }, "state_code": { "type": [ "string", "null" ] }, "country_code": { "type": [ "string", "null" ] } } } } } }, "education": { "type": "array", "items": { "type": "object", "properties": { "school_name": { "type": [ "string", "null" ] }, "degree": { "type": "string" }, "start_date": { "type": [ "string", "null" ], "format": "date" }, "end_date": { "type": [ "string", "null" ], "format": "date" } } } }, "skills": { "type": "array", "items": { "type": "string" } }, "certifications": { "type": "array", "items": { "type": "object", "properties": { "authority": { "type": "string" }, "name": { "type": "string" }, "url": { "type": [ "string", "null" ] } } } } } } } } }, "fair_usage": { "type": "object", "description": "Record usage, rate limit, and tracing data for this request.", "properties": { "records_used": { "type": "number", "description": "Records this request consumed, after reconciliation against the results actually returned.", "examples": [ 3 ] }, "records_remaining": { "type": "number", "description": "Records left on the plan after this request.", "examples": [ 9913547 ] }, "next_reset_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "When the record balance resets.", "examples": [ "2026-09-29T10:25:23.155Z" ] }, "rate_limit": { "type": "object", "description": "Absent on endpoints that are not rate limited.", "properties": { "requests_per_second": { "type": "number", "description": "Requests this API key may send per second on this endpoint. Set by your plan.", "examples": [ 10 ] }, "remaining_this_second": { "type": "number", "description": "Requests left in the current one-second window.", "examples": [ 9 ] } }, "required": [ "requests_per_second", "remaining_this_second" ], "additionalProperties": false }, "request_id": { "type": "string", "description": "Quote this id when you contact support.", "examples": [ "019bae09-0055-7441-b2ea-16086e499219" ] } }, "required": [ "records_used", "records_remaining", "next_reset_at", "request_id" ], "additionalProperties": false } } }, "example": { "company_linkedin_url": "https://www.linkedin.com/company/openai", "max_results": 3, "results_length": 3, "results": [ { "icp": 2, "ranking": 1, "person": { "first_name": "Gio", "last_name": "Santiago", "full_name": "Gio Santiago", "nickname": null, "civility_title": null, "headline": "Comms Events, Associate Events Manager, Gtm B2b Marketing | @OpenAI", "about_me": "Passionate, hands on, and innovation-centered events and digital media creative with 8+…", "location": { "city": "New York", "state_code": "NY", "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/gio-santiago", "connections_count": 500, "profile_picture_url": null, "experiences": [ { "company_name": "OpenAI", "job_title": "Comms Events, Associate Events Manager, Gtm B2b Marketing", "company_linkedin_url": "https://www.linkedin.com/company/openai", "company_linkedin_id": "c51425c5-1b38-578d-a700-c5ca850261ae", "company_domain": "openai.com", "job_description": "I am currently working as an associate event manager at OpenAI on the comms events team, producing marketing and GTM tentpoles across the US, EMEA, and APAC.", "job_start_date": "2025-05-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": "New York", "state_code": "NY", "country_code": "US" } } ], "education": [], "skills": [ "research", "ecology", "editing", "environmental science", "environmental education", "environmental awareness", "public speaking", "organizational leadership", "nonprofits", "community outreach", "management", "volunteer management" ], "certifications": [ { "authority": "Acumen, LLC", "name": "Adaptive Leadership Certification" }, { "authority": "PADI", "name": "PADI Advanced Open Water Scuba Diver" } ] } }, { "icp": 2, "ranking": 2, "person": { "first_name": "Alison", "last_name": "Harmon", "full_name": "Alison Harmon", "nickname": null, "civility_title": null, "headline": "Head of Growth | @OpenAI", "about_me": null, "location": { "city": "San Francisco", "state_code": "CA", "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/alisonharmon", "connections_count": 500, "profile_picture_url": null, "experiences": [ { "company_name": "OpenAI", "job_title": "Head of Growth", "company_linkedin_url": "https://www.linkedin.com/company/openai", "company_linkedin_id": "c51425c5-1b38-578d-a700-c5ca850261ae", "company_domain": "openai.com", "job_description": null, "job_start_date": "2023-09-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": null, "state_code": null, "country_code": null } } ], "education": [], "skills": [ "matlab", "crystal healing", "apis", "goats", "mathematica", "r", "microsoft word", "microsoft office", "weapons handling", "statistics", "calculus", "mathematical modeling", "astrophysics", "desk", "mathematical analysis", "science", "astrology", "asana", "linear algebra", "lead generation", "mathematics", "physics", "python" ], "certifications": [] } }, { "icp": 2, "ranking": 3, "person": { "first_name": "Pearl", "last_name": "Aguilar", "full_name": "Pearl Aguilar", "nickname": null, "civility_title": null, "headline": "Digital Marketing Manager | @OpenAI", "about_me": "With a proven track record in the digital marketing landscape, I specialize in driving…", "location": { "city": null, "state_code": null, "country_code": "GB", "continent": "Europe", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/pearl-aguilar-76b9b5208", "connections_count": 500, "profile_picture_url": null, "experiences": [ { "company_name": "OpenAI", "job_title": "Digital Marketing Manager", "company_linkedin_url": "https://www.linkedin.com/company/openai", "company_linkedin_id": "c51425c5-1b38-578d-a700-c5ca850261ae", "company_domain": "openai.com", "job_description": null, "job_start_date": "2024-06-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": "London", "state_code": null, "country_code": "GB" } } ], "education": [ { "school_name": null, "degree": "Bachelor of Engineering - BE", "start_date": null, "end_date": null } ], "skills": [], "certifications": [] } } ], "fair_usage": { "records_used": 3, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body, 2 errors. cascade[0].include_title: Required. cascade[0]: Unknown field \"include_titles\". Did you mean \"include_title\"?", "errors": [ { "field": "cascade[0].include_title", "message": "Required." }, { "field": "cascade[0]", "message": "Unknown field \"include_titles\". Did you mean \"include_title\"?" } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/search/employee-finder": { "post": { "tags": [ "People Search" ], "security": [ { "APIKey": [] } ], "summary": "Employee Finder", "description": "Search all employees at a single company by job level, department, location, and seniority.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/openai" }, "country_code": { "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2 }, "example": [ "US", "FR" ], "default": [ "WORLD" ] }, "continent": { "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Africa", "Antarctica", "Asia", "Europe", "North America", "Oceania", "South America" ] }, "example": [ "Africa", "Antarctica", "Asia", "Europe", "North America", "Oceania", "South America" ] }, "sales_region": { "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "NORAM", "LATAM", "EMEA", "APAC" ] }, "example": [ "NORAM", "LATAM", "EMEA", "APAC" ] }, "job_level": { "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "C-Team", "Director", "Manager", "Other", "Staff", "VP" ] }, "example": [ "C-Team", "Director", "Manager", "Other", "Staff", "VP" ] }, "job_function": { "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Advertising & Marketing", "Art, Culture and Creative Professionals", "Construction", "Customer/Client Service", "Education", "Engineering", "Finance & Accounting", "General Business & Management", "Healthcare & Human Services", "Human Resources", "Information Technology", "Legal", "Manufacturing & Production", "Operations", "Other", "Public Administration & Safety", "Purchasing", "Research & Development", "Sales & Business Development", "Science", "Supply Chain & Logistics", "Writing/Editing" ] }, "example": [ "Advertising & Marketing", "Art, Culture and Creative Professionals", "Construction", "Customer/Client Service", "Education", "Engineering", "Finance & Accounting", "General Business & Management", "Healthcare & Human Services", "Human Resources", "Information Technology", "Legal", "Manufacturing & Production", "Operations", "Other", "Public Administration & Safety", "Purchasing", "Research & Development", "Sales & Business Development", "Science", "Supply Chain & Logistics", "Writing/Editing" ] }, "min_connections_count": { "type": "number", "example": 200, "minimum": 0, "maximum": 500, "default": 0 }, "is_recent_hire": { "default": false, "examples": [ false ], "description": "Only people whose current job at the company started in the last 90 days. The job must also match job_level and job_function. A job with no start date never matches.", "type": "boolean" }, "max_results": { "description": "Maximum number of results to return.", "type": "number", "example": 3, "minimum": 1, "maximum": 50, "default": 10 }, "page": { "type": "number", "example": 1, "default": 1, "minimum": 1 } }, "required": [ "company_linkedin_url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "company_linkedin_url": "https://www.linkedin.com/company/openai", "max_results": 3, "results_length": 3, "page": 1, "total_pages": 1285, "results": [ { "first_name": "Eric", "last_name": "Mitchell", "full_name": "Eric Mitchell", "nickname": null, "civility_title": null, "headline": null, "about_me": "I co-lead (with Yann Dubois) the Post-training Frontiers team within Post-training at…", "location": { "city": null, "state_code": null, "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/ericanthonymitchell", "connections_count": 200, "profile_picture_url": null, "experiences": [ { "company_name": "OpenAI", "job_title": null, "company_linkedin_url": "https://www.linkedin.com/company/openai", "company_linkedin_id": "c51425c5-1b38-578d-a700-c5ca850261ae", "company_domain": "openai.com", "job_description": null, "job_start_date": null, "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": null, "state_code": null, "country_code": null } } ], "education": [], "skills": [ "java", "agile methodologies", "objective-c", "json", "mobile applications", "english", "software development", "python", "customer service", "c", "ios development", "scikit-learn", "xcode" ], "certifications": [] }, { "first_name": "Alex", "last_name": "Barron", "full_name": "Alex Barron", "nickname": null, "civility_title": null, "headline": "Member of Technical Staff | @OpenAI", "about_me": null, "location": { "city": "San Francisco", "state_code": "CA", "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/alexbarron1", "connections_count": 200, "profile_picture_url": null, "experiences": [ { "company_name": "OpenAI", "job_title": "Member of Technical Staff", "company_linkedin_url": "https://www.linkedin.com/company/openai", "company_linkedin_id": "c51425c5-1b38-578d-a700-c5ca850261ae", "company_domain": "openai.com", "job_description": null, "job_start_date": "2025-04-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": "San Francisco", "state_code": "CA", "country_code": "US" } } ], "education": [ { "school_name": null, "degree": "Bachelor of Science (BS)", "start_date": "2013-01-01", "end_date": "2017-01-01" }, { "school_name": null, "degree": "Master of Science (MS)", "start_date": "2016-01-01", "end_date": "2017-01-01" } ], "skills": [ "microsoft office", "python", "c++", "objective-c", "c", "javascript", "swift", "java" ], "certifications": [] }, { "first_name": "Shane", "last_name": "Copenhagen", "full_name": "Shane Copenhagen", "nickname": null, "civility_title": null, "headline": "Independent Contractor | @OpenAI", "about_me": "A Robotics Software Engineer with a BS in CS+Robotics from Colorado School of Mines. My…", "location": { "city": "Golden", "state_code": "CO", "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/shane-copenhagen", "connections_count": 200, "profile_picture_url": null, "experiences": [ { "company_name": "OpenAI", "job_title": "Independent Contractor", "company_linkedin_url": "https://www.linkedin.com/company/openai", "company_linkedin_id": "c51425c5-1b38-578d-a700-c5ca850261ae", "company_domain": "openai.com", "job_description": "Building AI-enabled tools and bots for the OpenAI Community.", "job_start_date": "2023-02-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": null, "state_code": null, "country_code": null } } ], "education": [], "skills": [ "javascript", "computers", "public speaking", "banking", "html5", "database design", "insurance", "life insurance", "spanish-english", "java", "css3" ], "certifications": [] } ], "fair_usage": { "records_used": 3, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. job_level[0]: Invalid value \"vp\". Allowed values: \"C-Team\", \"Director\", \"Manager\", \"Other\", \"Staff\", \"VP\".", "errors": [ { "field": "job_level[0]", "message": "Invalid value \"vp\". Allowed values: \"C-Team\", \"Director\", \"Manager\", \"Other\", \"Staff\", \"VP\"." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/search/people": { "post": { "summary": "Find People", "description": "Search decision-makers across many companies in a single call. Every result carries the person's full position history in experiences[], in profile order, not just the position that matched your filters.", "tags": [ "People Search" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company": { "description": "Company search criteria", "type": "object", "properties": { "linkedin_url": { "description": "Exact matches for the LinkedIn URL of the company, to look for people in the company", "type": "array", "items": { "type": "string", "examples": [ "https://www.linkedin.com/company/blitz-api" ] }, "maxItems": 50 }, "name": { "description": "Keywords searched in the company name", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "industry": { "description": "Exact matches for the industry search. `Unknown` matches a company with no industry on file, and a person with no company: in `include` it is added to the listed industries, in `exclude` it drops them.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "IT Services and IT Consulting" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } } }, "additionalProperties": false }, "type": { "description": "Exact matches for the company type search", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Educational", "Educational Institution", "Government Agency", "Nonprofit", "Partnership", "Privately Held", "Public Company", "Self-Employed", "Self-Owned", "Sole Proprietorship" ] } }, "exclude": { "default": [], "examples": [ [ "Nonprofit", "Partnership" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Educational", "Educational Institution", "Government Agency", "Nonprofit", "Partnership", "Privately Held", "Public Company", "Self-Employed", "Self-Owned", "Sole Proprietorship" ] } } }, "additionalProperties": false }, "employee_range": { "default": [], "examples": [ [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] ], "description": "Exact matches for the employee range search", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } }, "employee_count": { "description": "Range search on the company's employee count (the `employees_on_linkedin` value that Company Search returns)", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 980000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 } }, "additionalProperties": false }, "min_linkedin_followers": { "default": 0, "examples": [ 0 ], "description": "Minimum number of LinkedIn followers", "type": "number", "minimum": 0, "maximum": 10000000 }, "revenue": { "description": "Range search for company revenue (USD). Matches companies whose revenue band overlaps the requested range. 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 9007199254740991 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "naics_code": { "description": "Exact matches for NAICS codes", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "541511" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "sic_code": { "description": "Exact matches for SIC codes", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "7372" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "mx": { "description": "Mail provider of the company, from the MX records of its domains. Companies with no MX data are never matched by `include` and `exclude` never drops them, unless you use `any`.", "type": "object", "properties": { "provider": { "description": "Known mail providers, such as `google` or `microsoft`. A company matches when any of its domains uses the provider. `any` stands for every provider: in `include` it keeps companies with MX data, in `exclude` it keeps companies with no MX data. Use `include: [\"any\"], exclude: [\"google\"]` for companies with MX data that do not use Google.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "google" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "any", "google", "microsoft", "zoho", "godaddy", "proofpoint", "mimecast", "barracuda", "cloudflare", "ionos", "hostinger", "namecheap", "fastmail", "proton", "strato", "ovh", "siteground", "opensrs", "one_com", "tencent", "titan", "20i", "rackspace", "alibaba", "open_xchange", "infomaniak", "jimdo", "netease", "gandi", "register_it", "hetzner", "yahoo", "amazon", "yandex", "locaweb", "uol_host", "fasthosts", "kinghost", "t_online", "hostopia", "united_domains", "hostpoint", "mijndomein", "icloud", "reg123", "mailhostbox", "transip", "natro", "names_co_uk", "intermedia", "hostnet", "aruba", "loopia", "netcup", "lolipop", "simply", "domeneshop", "hornetsecurity", "mailchannels", "appriver", "trendmicro", "spamexperts", "cisco", "sophos", "mesh", "mailinblack" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "any", "google", "microsoft", "zoho", "godaddy", "proofpoint", "mimecast", "barracuda", "cloudflare", "ionos", "hostinger", "namecheap", "fastmail", "proton", "strato", "ovh", "siteground", "opensrs", "one_com", "tencent", "titan", "20i", "rackspace", "alibaba", "open_xchange", "infomaniak", "jimdo", "netease", "gandi", "register_it", "hetzner", "yahoo", "amazon", "yandex", "locaweb", "uol_host", "fasthosts", "kinghost", "t_online", "hostopia", "united_domains", "hostpoint", "mijndomein", "icloud", "reg123", "mailhostbox", "transip", "natro", "names_co_uk", "intermedia", "hostnet", "aruba", "loopia", "netcup", "lolipop", "simply", "domeneshop", "hornetsecurity", "mailchannels", "appriver", "trendmicro", "spamexperts", "cisco", "sophos", "mesh", "mailinblack" ] } } }, "additionalProperties": false } }, "additionalProperties": false }, "web_traffic": { "description": "Range search for total monthly web traffic (visits). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2147483647 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2147483647 } }, "additionalProperties": false }, "ad_spend": { "description": "Range search for monthly Google ad spend (USD). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 } }, "additionalProperties": false }, "total_funding": { "description": "Range search for total funding amount (USD). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 } }, "additionalProperties": false }, "last_funding_amount": { "description": "Range search for the last funding round amount (USD). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 } }, "additionalProperties": false }, "last_funding_year": { "description": "Range search for the year of the last funding round. 0 = unset, otherwise 1800 to 2026.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2026 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2026 } }, "additionalProperties": false }, "last_funding_type": { "description": "Exact matches for the last funding round type", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Series A" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Series unknown", "Pre seed", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E-J", "Grant", "Angel", "Private equity", "Debt financing", "Non equity assistance", "Post IPO equity", "Undisclosed", "Post IPO debt", "Product crowdfunding", "Equity crowdfunding", "Corporate round", "Convertible note", "Secondary market", "Initial coin offering", "Post IPO secondary" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Series unknown", "Pre seed", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E-J", "Grant", "Angel", "Private equity", "Debt financing", "Non equity assistance", "Post IPO equity", "Undisclosed", "Post IPO debt", "Product crowdfunding", "Equity crowdfunding", "Corporate round", "Convertible note", "Secondary market", "Initial coin offering", "Post IPO secondary" ] } } }, "additionalProperties": false }, "lead_investors": { "description": "Keywords searched in lead investor names", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Sequoia" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "keywords": { "description": "Keywords searched across the company description, specialties, NAICS/SIC descriptions, and Crunchbase/G2 categories. A phrase matches a company if all its tokens are found within any one of those fields.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Tech" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [ "Finance", "Marketing" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "founded_year": { "description": "Range search for the year the company was founded", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000 } }, "additionalProperties": false }, "hq": { "description": "Location of the headquarters of the company", "type": "object", "properties": { "city": { "description": "Keywords searched to find the headquarters city of the company", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "City" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [ "New" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "state": { "description": "Keywords searched to find the headquarters state/province of the company", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "California" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [ "Texas" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "country_code": { "default": [], "examples": [ [] ], "description": "Exact matches for the country code of the headquarters", "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "continent": { "default": [], "examples": [ [] ], "description": "Exact matches for the continent of the headquarters", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Africa", "Antarctica", "Asia", "Europe", "North America", "Oceania", "South America" ] } }, "sales_region": { "default": [], "examples": [ [] ], "description": "Exact matches for the sales region of the headquarters", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "NORAM", "LATAM", "EMEA", "APAC" ] } } }, "additionalProperties": false } }, "additionalProperties": false }, "people": { "description": "People search criteria for company matching", "type": "object", "properties": { "job_title": { "description": "Find at least one person with the given job title in the company. Values match as a keyword search by default; wrap a value in square brackets (`\"[CEO]\"`) to require an exact, case- and accent-insensitive match. See [Field normalization](/guide/reference/normalization/filters#exact-match-syntax).", "type": "object", "properties": { "include_linkedin_headline": { "default": false, "examples": [ false ], "description": "Whether to include the LinkedIn headline in the job_title search", "type": "boolean" }, "include": { "default": [], "examples": [ [ "Software Engineer" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [ "CTO" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "job_function": { "default": [], "examples": [ [ "Advertising & Marketing" ] ], "description": "Exact matches for the job function search", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Advertising & Marketing", "Art, Culture and Creative Professionals", "Construction", "Customer/Client Service", "Education", "Engineering", "Finance & Accounting", "General Business & Management", "Healthcare & Human Services", "Human Resources", "Information Technology", "Legal", "Manufacturing & Production", "Operations", "Other", "Public Administration & Safety", "Purchasing", "Research & Development", "Sales & Business Development", "Science", "Supply Chain & Logistics", "Writing/Editing" ] } }, "job_level": { "examples": [ [ "VP", "Director" ] ], "description": "Exact matches for the job level search", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "C-Team", "Director", "Manager", "Other", "Staff", "VP" ] } }, "min_connections": { "default": 0, "examples": [ 500 ], "description": "Minimum number of LinkedIn connections to find", "type": "number", "minimum": 0, "maximum": 500 }, "is_recent_hire": { "default": false, "examples": [ false ], "description": "Only people with a job that started in the last 90 days. The job must also match the other job and company filters. A job with no start date never matches. It covers the jobs that `include_active_jobs` and `include_past_jobs` select (current jobs by default).", "type": "boolean" }, "location": { "description": "Location of the people to find", "type": "object", "properties": { "city": { "description": "Keywords searched to find the city where the person is based", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Paris", "London" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [ "Remote" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "country_code": { "default": [], "examples": [ [ "FR", "GB" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 3 } }, "continent": { "default": [], "examples": [ [ "Europe" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Africa", "Antarctica", "Asia", "Europe", "North America", "Oceania", "South America" ] } }, "sales_region": { "default": [], "examples": [ [ "EMEA" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "NORAM", "LATAM", "EMEA", "APAC" ] } } }, "additionalProperties": false }, "education": { "description": "Education filter for the person. Phrases are matched against each education entry independently: tokens within a phrase must co-occur inside a single entry (school, degree, dates), so a phrase like \"Stanford 2025\" matches a person who studied at Stanford ending in 2025, not someone with separate Stanford and 2025 entries.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Stanford CS 2025", "MIT" ] ], "description": "Phrases matched against education entries. Tokens must co-occur within a single entry, so wrap the year in the phrase (e.g. \"Stanford 2025\") to correlate school and year. Token order is not significant (\"Stanford CS\" matches \"CS Stanford\"). Multiple phrases are OR-ed.", "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [ "Bootcamp" ] ], "description": "Phrases excluded from education entries: any person with an entry matching one of these phrases is filtered out.", "maxItems": 50, "type": "array", "items": { "type": "string" } }, "start_year": { "description": "Range search for the year an education entry started. 0 = unset. Applies to the same entry as include; an entry with no start year never matches a bound.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 2016 ], "type": "integer", "minimum": 0, "maximum": 2100 }, "max": { "default": 0, "examples": [ 2020 ], "type": "integer", "minimum": 0, "maximum": 2100 } }, "additionalProperties": false }, "end_year": { "description": "Range search for the year an education entry ended (graduation year). 0 = unset. Applies to the same entry as include; an entry with no end year never matches a bound.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 2018 ], "type": "integer", "minimum": 0, "maximum": 2100 }, "max": { "default": 0, "examples": [ 2022 ], "type": "integer", "minimum": 0, "maximum": 2100 } }, "additionalProperties": false } }, "additionalProperties": false }, "include_active_jobs": { "default": true, "examples": [ true ], "description": "Search the current jobs of each person. The job, company and job title filters must hold in the same job. The matched job is returned in `experiences`, and `job_is_current` says whether it is current.", "type": "boolean" }, "include_past_jobs": { "default": false, "examples": [ false ], "description": "Also search the past jobs of each person. A person is returned once, with the matched job; a current job is preferred to a past one.", "type": "boolean" } }, "additionalProperties": false }, "max_results": { "default": 10, "examples": [ 10 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "examples": [ null ], "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "additionalProperties": false, "example": { "company": { "linkedin_url": [], "name": { "include": [], "exclude": [] }, "industry": { "include": [], "exclude": [] }, "type": { "include": [], "exclude": [] }, "employee_range": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ], "employee_count": { "min": 1, "max": 0 }, "min_linkedin_followers": 1, "revenue": { "min": 0, "max": 0 }, "naics_code": { "include": [], "exclude": [] }, "sic_code": { "include": [], "exclude": [] }, "web_traffic": { "min": 0, "max": 0 }, "ad_spend": { "min": 0, "max": 0 }, "total_funding": { "min": 0, "max": 0 }, "last_funding_amount": { "min": 0, "max": 0 }, "last_funding_year": { "min": 0, "max": 0 }, "last_funding_type": { "include": [], "exclude": [] }, "lead_investors": { "include": [], "exclude": [] }, "keywords": { "include": [], "exclude": [] }, "founded_year": { "min": 0, "max": 0 }, "hq": { "city": { "include": [], "exclude": [] }, "country_code": [], "continent": [], "sales_region": [] } }, "people": { "job_title": { "include_linkedin_headline": false, "include": [], "exclude": [] }, "job_function": [], "job_level": [], "min_connections": 500, "location": { "city": { "include": [], "exclude": [] }, "country_code": [ "US" ], "continent": [], "sales_region": [] }, "education": { "include": [], "exclude": [] } }, "max_results": 3, "cursor": null } } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "total_results": 14337505, "results": [ { "first_name": "Roman", "last_name": "Orunbayev", "full_name": "Roman Orunbayev", "nickname": null, "civility_title": null, "headline": null, "about_me": "Linux Administrator with over 5 years of experience in varied industries…", "location": { "city": "Owasso", "state_code": "OK", "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/orro", "connections_count": 500, "profile_picture_url": null, "experiences": [ { "company_name": "Google", "job_title": null, "company_linkedin_url": "https://www.linkedin.com/company/google", "company_linkedin_id": "c346a3f2-6914-51e8-bb11-7da93440a3c0", "company_domain": "google.com", "job_description": null, "job_start_date": null, "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": null, "state_code": null, "country_code": null } } ], "education": [], "skills": [], "certifications": [ { "authority": "ZiyoTek Institute of Technology", "name": "DevOps Engineer Diploma", "url": "https://www.credly.com/badges/3708542b-26a2-4845-bd42-932727a1db9e" }, { "authority": "Red Hat", "name": "Red Hat Certified System Administrator (RHCSA)", "url": "https://rhtapps.redhat.com/verify" } ] }, { "first_name": "Beulah", "last_name": "Lee", "full_name": "Beulah Lee", "nickname": null, "civility_title": null, "headline": "Software Engineer | @Google", "about_me": "I am a highly motivated and self-disciplined software engineer with a strong foundation…", "location": { "city": "Sunnyvale", "state_code": "CA", "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/beulah-lee", "connections_count": 500, "profile_picture_url": null, "experiences": [ { "company_name": "Google", "job_title": "Software Engineer", "company_linkedin_url": "https://www.linkedin.com/company/google", "company_linkedin_id": "c346a3f2-6914-51e8-bb11-7da93440a3c0", "company_domain": "google.com", "job_description": "Google Workspace", "job_start_date": "2025-04-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": "Sunnyvale", "state_code": "CA", "country_code": "US" } }, { "company_name": "Stripe", "job_title": "Software Engineer Intern", "company_linkedin_url": "https://www.linkedin.com/company/stripe", "company_linkedin_id": "8a4ff2c1-5d07-5b3e-9c62-1f9de4a7b850", "company_domain": "stripe.com", "job_description": null, "job_start_date": "2022-06-01", "job_end_date": "2022-09-01", "job_is_current": false, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": "San Francisco", "state_code": "CA", "country_code": "US" } } ], "education": [ { "school_name": null, "degree": "Bachelor's degree", "start_date": "2019-01-01", "end_date": "2023-01-01" }, { "school_name": null, "degree": "Leadership Certificate", "start_date": "2019-01-01", "end_date": "2021-01-01" }, { "school_name": null, "degree": "Minor", "start_date": "2022-01-01", "end_date": "2023-01-01" } ], "skills": [], "certifications": [ { "authority": "Google", "name": "Google Cloud Cybersecurity Certificate", "url": "https://www.credly.com/badges/755d5778-3462-4f74-bbbb-aa2c6b69be2c/public_url" }, { "authority": "Amazon Web Services (AWS)", "name": "AWS Certified Cloud Practitioner Certification", "url": "https://www.credly.com/badges/97bf3cd5-94a1-4d79-a672-547bb99f6a48/public_url" }, { "authority": "Discover Financial Services", "name": "Certified Application Security Professional" } ] }, { "first_name": "Tran", "last_name": "Hang", "full_name": "Tran Hang", "nickname": null, "civility_title": null, "headline": "Director Global Product Solutions Performance Max, Lead Gen, Local, Travel | @Google", "about_me": "Professional with: Extensive experience in product strategy, go-to-market operations…", "location": { "city": null, "state_code": null, "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/tranhang", "connections_count": 500, "profile_picture_url": null, "experiences": [ { "company_name": "Google", "job_title": "Director Global Product Solutions Performance Max, Lead Gen, Local, Travel", "company_linkedin_url": "https://www.linkedin.com/company/google", "company_linkedin_id": "c346a3f2-6914-51e8-bb11-7da93440a3c0", "company_domain": "google.com", "job_description": null, "job_start_date": "2025-05-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": null, "state_code": null, "country_code": null } }, { "company_name": "Meta", "job_title": "Group Product Manager", "company_linkedin_url": "https://www.linkedin.com/company/meta", "company_linkedin_id": "5f2b7a90-4c18-59d2-bb37-6ea01c3d9f44", "company_domain": "meta.com", "job_description": null, "job_start_date": "2016-02-01", "job_end_date": "2020-11-01", "job_is_current": false, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": "Menlo Park", "state_code": "CA", "country_code": "US" } } ], "education": [ { "school_name": null, "degree": "Master of Business Administration - MBA", "start_date": null, "end_date": null }, { "school_name": null, "degree": "Bachelor of Arts", "start_date": null, "end_date": null }, { "school_name": null, "degree": "Bachelor's degree", "start_date": "1996-01-01", "end_date": "2000-01-01" } ], "skills": [ "sem", "online marketing", "marketing strategy" ], "certifications": [] } ], "results_length": 3, "max_results": 3, "cursor": "eyJzIjpbNTAwLDQwNTE3ODE4LDMzMTk2MV0sIm8iOjN9.p_8tss535KvrL-hmwsnW9JfW7rHHbt2NLQuVODC3bjw", "fair_usage": { "records_used": 3, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. company.industry.include[0]: Invalid value \"Software\". Did you mean \"Computer Software\", \"Software Development\" or \"Embedded Software Products\"?", "errors": [ { "field": "company.industry.include[0]", "message": "Invalid value \"Software\". Did you mean \"Computer Software\", \"Software Development\" or \"Embedded Software Products\"?" } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Service temporarily unavailable, please try again later" } } } } } }, "operationId": "postV2SearchPeople" } }, "/v2/search/companies": { "post": { "summary": "Company Search", "description": "Find companies matching ICP criteria (industry, size, location, keywords).", "tags": [ "Company Search" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company": { "description": "Company search criteria", "type": "object", "properties": { "name": { "description": "Keywords searched in the company name", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "industry": { "description": "Exact matches for the industry search. `Unknown` matches companies with no industry on file: in `include` it is added to the listed industries, in `exclude` it drops them.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "IT Services and IT Consulting" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } } }, "additionalProperties": false }, "type": { "description": "Exact matches for the company type search", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Educational", "Educational Institution", "Government Agency", "Nonprofit", "Partnership", "Privately Held", "Public Company", "Self-Employed", "Self-Owned", "Sole Proprietorship" ] } }, "exclude": { "default": [], "examples": [ [ "Nonprofit", "Partnership" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Educational", "Educational Institution", "Government Agency", "Nonprofit", "Partnership", "Privately Held", "Public Company", "Self-Employed", "Self-Owned", "Sole Proprietorship" ] } } }, "additionalProperties": false }, "employee_range": { "default": [], "examples": [ [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] ], "description": "Exact matches for the employee range search", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } }, "employee_count": { "description": "Range search on the company's employee count (the `employees_on_linkedin` value returned in results)", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 980000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 } }, "additionalProperties": false }, "min_linkedin_followers": { "default": 0, "examples": [ 1 ], "description": "Minimum number of LinkedIn followers", "type": "number", "minimum": 0, "maximum": 10000000 }, "revenue": { "description": "Range search for company revenue (USD). Matches companies whose revenue band overlaps the requested range. 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 9007199254740991 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "naics_code": { "description": "Exact matches for NAICS codes", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "541511" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "sic_code": { "description": "Exact matches for SIC codes", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "7372" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "mx": { "description": "Mail provider of the company, from the MX records of its domains. Companies with no MX data are never matched by `include` and `exclude` never drops them, unless you use `any`.", "type": "object", "properties": { "provider": { "description": "Known mail providers, such as `google` or `microsoft`. A company matches when any of its domains uses the provider. `any` stands for every provider: in `include` it keeps companies with MX data, in `exclude` it keeps companies with no MX data. Use `include: [\"any\"], exclude: [\"google\"]` for companies with MX data that do not use Google.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "google" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "any", "google", "microsoft", "zoho", "godaddy", "proofpoint", "mimecast", "barracuda", "cloudflare", "ionos", "hostinger", "namecheap", "fastmail", "proton", "strato", "ovh", "siteground", "opensrs", "one_com", "tencent", "titan", "20i", "rackspace", "alibaba", "open_xchange", "infomaniak", "jimdo", "netease", "gandi", "register_it", "hetzner", "yahoo", "amazon", "yandex", "locaweb", "uol_host", "fasthosts", "kinghost", "t_online", "hostopia", "united_domains", "hostpoint", "mijndomein", "icloud", "reg123", "mailhostbox", "transip", "natro", "names_co_uk", "intermedia", "hostnet", "aruba", "loopia", "netcup", "lolipop", "simply", "domeneshop", "hornetsecurity", "mailchannels", "appriver", "trendmicro", "spamexperts", "cisco", "sophos", "mesh", "mailinblack" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "any", "google", "microsoft", "zoho", "godaddy", "proofpoint", "mimecast", "barracuda", "cloudflare", "ionos", "hostinger", "namecheap", "fastmail", "proton", "strato", "ovh", "siteground", "opensrs", "one_com", "tencent", "titan", "20i", "rackspace", "alibaba", "open_xchange", "infomaniak", "jimdo", "netease", "gandi", "register_it", "hetzner", "yahoo", "amazon", "yandex", "locaweb", "uol_host", "fasthosts", "kinghost", "t_online", "hostopia", "united_domains", "hostpoint", "mijndomein", "icloud", "reg123", "mailhostbox", "transip", "natro", "names_co_uk", "intermedia", "hostnet", "aruba", "loopia", "netcup", "lolipop", "simply", "domeneshop", "hornetsecurity", "mailchannels", "appriver", "trendmicro", "spamexperts", "cisco", "sophos", "mesh", "mailinblack" ] } } }, "additionalProperties": false } }, "additionalProperties": false }, "web_traffic": { "description": "Range search for total monthly web traffic (visits). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2147483647 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2147483647 } }, "additionalProperties": false }, "ad_spend": { "description": "Range search for monthly Google ad spend (USD). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 } }, "additionalProperties": false }, "total_funding": { "description": "Range search for total funding amount (USD). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 } }, "additionalProperties": false }, "last_funding_amount": { "description": "Range search for the last funding round amount (USD). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 } }, "additionalProperties": false }, "last_funding_year": { "description": "Range search for the year of the last funding round. 0 = unset, otherwise 1800 to 2026.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2026 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2026 } }, "additionalProperties": false }, "last_funding_type": { "description": "Exact matches for the last funding round type", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Series A" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Series unknown", "Pre seed", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E-J", "Grant", "Angel", "Private equity", "Debt financing", "Non equity assistance", "Post IPO equity", "Undisclosed", "Post IPO debt", "Product crowdfunding", "Equity crowdfunding", "Corporate round", "Convertible note", "Secondary market", "Initial coin offering", "Post IPO secondary" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Series unknown", "Pre seed", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E-J", "Grant", "Angel", "Private equity", "Debt financing", "Non equity assistance", "Post IPO equity", "Undisclosed", "Post IPO debt", "Product crowdfunding", "Equity crowdfunding", "Corporate round", "Convertible note", "Secondary market", "Initial coin offering", "Post IPO secondary" ] } } }, "additionalProperties": false }, "lead_investors": { "description": "Keywords searched in lead investor names", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Sequoia" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "keywords": { "description": "Keywords searched across the company description, specialties, NAICS/SIC descriptions, and Crunchbase/G2 categories. A phrase matches a company if all its tokens are found within any one of those fields.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Tech" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [ "Finance", "Marketing" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "founded_year": { "description": "Range search for the year the company was founded", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000 } }, "additionalProperties": false }, "hq": { "description": "Location of the headquarters of the company", "type": "object", "properties": { "city": { "description": "Keywords searched to find the headquarters city of the company", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "City" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [ "New" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "state": { "description": "Keywords searched to find the headquarters state/province of the company", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "California" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [ "Texas" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "country_code": { "default": [], "examples": [ [] ], "description": "Exact matches for the country code of the headquarters", "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 3 } }, "continent": { "default": [], "examples": [ [] ], "description": "Exact matches for the continent of the headquarters", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Africa", "Antarctica", "Asia", "Europe", "North America", "Oceania", "South America" ] } }, "sales_region": { "default": [], "examples": [ [] ], "description": "Exact matches for the sales region of the headquarters", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "NORAM", "LATAM", "EMEA", "APAC" ] } } }, "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 10, "examples": [ 10 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "examples": [ null ], "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "additionalProperties": false }, "example": { "company": { "name": { "include": [], "exclude": [] }, "industry": { "include": [ "IT Services and IT Consulting" ], "exclude": [] }, "type": { "include": [], "exclude": [ "Nonprofit", "Partnership" ] }, "employee_range": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ], "employee_count": { "min": 0, "max": 0 }, "min_linkedin_followers": 1, "revenue": { "min": 0, "max": 0 }, "naics_code": { "include": [], "exclude": [] }, "sic_code": { "include": [], "exclude": [] }, "web_traffic": { "min": 0, "max": 0 }, "ad_spend": { "min": 0, "max": 0 }, "total_funding": { "min": 0, "max": 0 }, "last_funding_amount": { "min": 0, "max": 0 }, "last_funding_year": { "min": 0, "max": 0 }, "last_funding_type": { "include": [], "exclude": [] }, "lead_investors": { "include": [], "exclude": [] }, "keywords": { "include": [ "Tech" ], "exclude": [] }, "founded_year": { "min": 0, "max": 0 }, "hq": { "city": { "include": [ "City" ], "exclude": [ "New" ] }, "country_code": [], "continent": [], "sales_region": [] } }, "max_results": 3, "cursor": null } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "total_results": 100, "results": [ { "linkedin_url": "https://www.linkedin.com/company/google", "linkedin_id": 1441, "name": "Google", "about": "A problem isn\\'t truly solved until it\\'s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone. Check out our career opportunities at goo.gle/3DLEokh", "specialties": [ "mobile", "hardware", "youtube", "machine learning", "artificial intelligence", "software", "search", "apps", "cloud", "online video", "virtual reality", "roid", "ads" ], "industry": "Software Development", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 328177, "followers": 40093219, "founded_year": null, "hq": { "city": "Mountain View", "state": "California", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America" }, "domain": "google.com", "website": "https://www.google.com" }, { "linkedin_url": "https://www.linkedin.com/company/amazon", "linkedin_id": 1586, "name": "Amazon", "about": "Amazon is guided by four principles: customer obsession rather than competitor focus, passion for invention, commitment to operational excellence, and long-term thinking. We are driven by the excitement of building technologies, inventing products, and providing services that change lives. We embrace new ways of doing things, make decisions quickly, and are not afraid to fail. We have the scope and capabilities of a large company, and the spirit and heart of a small one. Together, Amazonians research and develop new technologies from Amazon Web Services to Alexa on behalf of our customers: shoppers, sellers, content creators, and developers around the world. Our mission is to be Earth\\'s most customer-centric company. Our actions, goals, projects, programs, and inventions begin and end with the customer top of mind. You\\'ll also hear us say that at Amazon, it\\'s always \\\"Day 1.\\\" What do we mean? That our approach remains the same as it was on Amazon\\'s very first day - to make smart, fast decisions, stay nimble, invent, and focus on delighting our customers.", "specialties": [ "operations", "internet", "retail", "e-commerce" ], "industry": "Software Development", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 778681, "followers": 35961516, "founded_year": null, "hq": { "city": "Seattle", "state": "Washington", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America" }, "domain": "amazon.com", "website": "https://www.amazon.com" }, { "linkedin_url": "https://www.linkedin.com/company/1337", "linkedin_id": 1337, "name": "Linkedin", "about": "Founded in 2003, LinkedIn connects the world\\'s professionals to make them more productive and successful. With more than 1 billion members worldwide, including executives from every Fortune 500 company, LinkedIn is the world\\'s largest professional network. The company has a diversified business model with revenue coming from Talent Solutions, Marketing Solutions, Sales Solutions and Premium Subscriptions products. Headquartered in Silicon Valley, LinkedIn has offices across the globe.", "specialties": [ "address book", "recruiting", "people search", "group collaboration", "online professional network", "company search", "jobs", "professional identity", "advertising" ], "industry": "Software Development", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 23910, "followers": 32612546, "founded_year": null, "hq": { "city": "Sunnyvale", "state": "California", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America" }, "domain": null, "website": "https://www.linkedin.com" }, { "linkedin_url": "https://www.linkedin.com/company/microsoft", "linkedin_id": 1035, "name": "Microsoft", "about": "Every company has a mission. What\\'s ours? To empower every person and every organization to achieve more. We believe technology can and should be a force for good and that meaningful innovation contributes to a brighter world in the future and today. Our culture doesn’t just encourage curiosity; it embraces it. Each day we make progress together by showing up as our authentic selves. We show up with a learn-it-all mentality. We show up cheering on others, knowing their success doesn\\'t diminish our own. We show up every day open to learning our own biases, changing our behavior, and inviting in differences. Because impact matters. Microsoft operates in 190 countries and is made up of approximately passionate employees worldwide.", "specialties": [ "windows operating system", "laptops", "ai", "machine learning", "developers", "artificial intelligence", "smartphones", "search", "gaming", "developer tools", "windows applications platforms", "business software", "future of work", "quantum computing", "mixed reality", "servers", "home educational software", "cloud computing", "productivity", "virtual reality", "it professional", "advertising", "tablets" ], "industry": "Software Development", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 226469, "followers": 27230107, "founded_year": null, "hq": { "city": "Redmond", "state": "Washington", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America" }, "domain": "microsoft.com", "website": "https://www.microsoft.com" }, { "linkedin_url": "https://www.linkedin.com/company/ted-conferences", "linkedin_id": 610087, "name": "Ted Conferences", "about": "TED’s mission is to discover and champion the ideas that will shape tomorrow. Powerful ideas, powerfully presented, can move us to feel something, to think differently, to take action and create a brighter future. TED finds these powerful ideas across disciplines and around the globe, from people who passionately seek a deeper understanding of the world and want to make a difference in it. TED’s spotlight, and its engaged, open-minded audience, help these ideas to create real impact: to shift one person’s perspective, to make a difference within a community or to spark global transformation. Ideas change everything.", "specialties": null, "industry": "Non-profit Organizations", "type": "Nonprofit", "size": "51-200", "employees_on_linkedin": 15142, "followers": 24489098, "founded_year": null, "hq": { "city": "New York", "state": "New York", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America" }, "domain": null, "website": "https://www.ted.com" }, { "linkedin_url": "https://www.linkedin.com/company/deloitte", "linkedin_id": 1038, "name": "Deloitte", "about": "Deloitte drives progress. Our firms around the world help clients become leaders wherever they choose to compete. Deloitte invests in outstanding people of diverse talents and backgrounds and empowers them to achieve more than they could elsewhere. Our work combines advice with action and integrity. We believe that when our clients and society are stronger, so are we. Deloitte refers to one or more of Deloitte Touche Tohmatsu Limited (“DTTL”), its global network of member firms, and their related entities. DTTL (also referred to as “Deloitte Global”) and each of its member firms are legally separate and independent entities. DTTL does not provide services to clients. Please see to learn more. The content on this page contains general information only, and none of Deloitte Touche Tohmatsu Limited, its member firms, or their related entities (collectively the “Deloitte Network”) is, by means of this publication, rendering professional advice or services. Before making any decision or taking any action that may affect your finances or your business, you should consult a qualified professional adviser. No entity in the Deloitte Network shall be responsible for any loss whatsoever sustained by any person who relies on content from this page.", "specialties": [ "risk management", "audit assurance", "tax legal", "consulting", "financial advisory" ], "industry": "Business Consulting and Services", "type": "Privately Held", "size": "10001+", "employees_on_linkedin": 505669, "followers": 20561823, "founded_year": 1845, "hq": { "city": null, "state": null, "country_code": null, "country_name": null, "region": null, "continent": null }, "domain": "deloitte.com", "website": "https://www2.deloitte.com/cz/cs.html" }, { "linkedin_url": "https://www.linkedin.com/company/unilever", "linkedin_id": 1248, "name": "Unilever", "about": "Every day, 3.4 billion people around the world enjoy our products - from ground-breaking brands like Hellmann\\'s, Domestos, Dove and Rexona (to name just a few). Our brands lead the way - innovating in their fields, delighting their consumers and powering our business forward. And it is our people who make everything happen. Our bright and curious people who imagine and create the future - diverse, passionate and ambitious people. A role with us means endless opportunities with global brands that make markets and people who play to win. We make markets and create cultures through some of the biggest brands and best-known products in the world. Talented teams in 190 countries redefine the way we do business and set new standards for our brands. Always learning, always innovating. Is this your moment?", "specialties": [ "refreshments", "purpose", "ice cream", "home care", "fmcg", "careers", "nutrition", "consumer goods", "sustainability", "personal care", "beauty wellbeing", "digital", "retail", "innovation", "food", "marketing advertising" ], "industry": "Manufacturing", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 128402, "followers": 20535770, "founded_year": 1872, "hq": { "city": null, "state": null, "country_code": null, "country_name": null, "region": null, "continent": null }, "domain": "unilever.com", "website": "https://www.unilever.com" }, { "linkedin_url": "https://www.linkedin.com/company/ibm", "linkedin_id": 1009, "name": "Ibm", "about": "At IBM, we do more than work. We create. We create as technologists, developers, and engineers. We create with our partners. We create with our competitors. If you\\'re searching for ways to make the world work better through technology and infrastructure, software and consulting, then we want to work with you. We\\'re here to help every creator turn their \\\"what if\\\" into what is. Let\\'s create something that will change everything.", "specialties": [ "analytics", "technology support", "research", "financing", "commerce", "resiliency services", "systems services", "cognitive", "internet of things", "mobile", "experience design", "security", "watson", "cloud", "consulting", "industry solutions", "it infrastructure" ], "industry": "IT Services and IT Consulting", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 341782, "followers": 19054091, "founded_year": null, "hq": { "city": null, "state": null, "country_code": null, "country_name": null, "region": null, "continent": null }, "domain": "ibm.com", "website": "https://www.ibm.com" }, { "linkedin_url": "https://www.linkedin.com/company/tata-consultancy-services", "linkedin_id": 1353, "name": "Tata Consultancy Services", "about": "Tata Consultancy Services (TCS) is an IT services, consulting, and business solutions organization that has been partnering with many of the world’s largest businesses in their transformation journeys since its inception in 1968. Our consulting led, innovation-driven services help businesses evolve as perpetually adaptive enterprises, staying ahead in an ever changing digital landscape. Recognized for excellence in software development, we rapidly apply and scale new technologies, driving long-term value and scalable transformation. Many of these relationships have endured for decades, navigating every technology cycle from mainframes in the 1970s to Artificial Intelligence today. A part of the Tata Group, India’s largest multinational business group, TCS has a highly skilled workforce spread across 55 countries and 202 service delivery centers across the world. Caution against fraudulent job offers: TCS doesn’t charge any fee throughout the recruitment process. Refer here:", "specialties": [ "it services", "consulting", "business solutions" ], "industry": "IT Services and IT Consulting", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 692634, "followers": 18329200, "founded_year": 1968, "hq": { "city": "Mumbai", "state": null, "country_code": "IN", "country_name": "India", "region": "APAC", "continent": "Asia" }, "domain": "tcs.com", "website": "https://www.tcs.com" }, { "linkedin_url": "https://www.linkedin.com/company/forbes-magazine", "linkedin_id": 5597, "name": "Forbes", "about": "Forbes Media is a global media, branding and technology company, with a focus on news and information about business, investing, technology, entrepreneurship, leadership and affluent lifestyles. The company publishes Forbes, Forbes Asia, and Forbes Europe magazines as well as Forbes.com. The Forbes brand today reaches more than 94 million people worldwide with its business message each month through its magazines and 37 licensed local editions around the globe, Forbes.com, TV, conferences, research, social and mobile platforms. Forbes Media’s brand extensions include conferences, real estate, education, financial services, and technology license agreements. Forbes is an equal opportunity employer.", "specialties": [ "technology", "politics", "entrepreneurship", "management", "security", "finance", "business", "cloud computing", "investing", "small business", "leadership" ], "industry": "Book and Periodical Publishing", "type": "Privately Held", "size": "201-500", "employees_on_linkedin": 10018, "followers": 18097929, "founded_year": 1917, "hq": { "city": "Jersey City", "state": "New Jersey", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America" }, "domain": "forbes.com", "website": "https://www.forbes.com" } ], "results_length": 10, "max_results": 10, "cursor": "eyJpIjoiY2E5OTcxZjUtYmI1NS01MWFlLTg0ZTMtN2I3ZDJjYTU0MjNmIiwiZiI6MTgwOTc5MjksImUiOjEwMDE4fQ==", "fair_usage": { "records_used": 10, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. company.employee_range[0]: Invalid value \"50-200\". Allowed values: \"1-10\", \"11-50\", \"51-200\", \"201-500\", \"501-1000\", \"1001-5000\", \"5001-10000\", \"10001+\".", "errors": [ { "field": "company.employee_range[0]", "message": "Invalid value \"50-200\". Allowed values: \"1-10\", \"11-50\", \"51-200\", \"201-500\", \"501-1000\", \"1001-5000\", \"5001-10000\", \"10001+\"." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Service temporarily unavailable, please try again later" } } } } } }, "operationId": "postV2SearchCompanies" } }, "/v2/company/tam-by-jobs": { "post": { "summary": "TAM By Jobs", "description": "Returns the distinct companies hiring for the matching jobs (deduplicated), each with its matched-jobs count. Optional job.min_per_company floors that count; when it filters heavily, a page may be partial, so keep paging until cursor is null. Cost: 1 record per result (max = max_results)", "tags": [ "Company Search" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "job": { "description": "Job-level search criteria", "type": "object", "properties": { "title": { "description": "Keywords matched against the job title only (strict role search). Values match as a keyword search by default; wrap a value in square brackets (`\"[Head of Sales]\"`) to require an exact, case- and accent-insensitive match. See [Field normalization](/guide/reference/normalization/filters#exact-match-syntax).", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "description": { "description": "Keywords matched against the job description content", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "ai_keywords": { "description": "Broad theme search across title, description, skills, responsibilities, requirements and taxonomies", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "field": { "description": "The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form: accepts any field label.", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "seniority": { "description": "The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } } }, "additionalProperties": false }, "employment_type": { "description": "The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } } }, "additionalProperties": false }, "work_arrangement": { "description": "Where the work is performed: on-site, hybrid, or remote.", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } } }, "additionalProperties": false }, "location": { "description": "Job location (not company HQ).", "type": "object", "properties": { "city": { "description": "Job location city (exact, case/accent-insensitive)", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the job location country", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false }, "date_posted": { "description": "Only jobs posted within the last N days", "type": "object", "properties": { "last_days": { "type": "integer", "minimum": 1, "maximum": 3650, "examples": [ 30 ] } }, "required": [ "last_days" ], "additionalProperties": false }, "min_per_company": { "default": 0, "examples": [ 0 ], "description": "Only return companies with at least this many matching jobs (max 25). 0 = unset.", "type": "number", "minimum": 0, "maximum": 25 } }, "additionalProperties": false }, "company": { "description": "Company-level firmographic criteria (enriched from the internal company record)", "type": "object", "properties": { "is_agency": { "description": "true = only recruitment/staffing agencies, false = exclude confirmed agencies, null/omitted = both", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "industry": { "description": "Exact matches on the enriched company's industry. `Unknown` matches a company with no industry on file, and a job with no company: in `include` it is added to the listed industries, in `exclude` it drops them.", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } } }, "additionalProperties": false }, "employee_count": { "description": "Range search on the enriched company's headcount. 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 } }, "additionalProperties": false }, "size": { "description": "Exact matches on the enriched company's size bucket", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "51-200", "201-500" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } } }, "additionalProperties": false }, "keywords": { "description": "Keywords matched against the enriched company positioning / firmographic text", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "hq": { "description": "Company headquarters (not job location)", "type": "object", "properties": { "city": { "description": "Keywords matched against the enriched company HQ city. Values match as a keyword search by default; wrap a value in square brackets (`\"[Paris]\"`) to require an exact, case- and accent-insensitive match. See [Field normalization](/guide/reference/normalization/filters#exact-match-syntax).", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "state": { "description": "Keywords matched against the enriched company HQ state/region. Values match as a keyword search by default; wrap a value in square brackets (`\"[California]\"`) to require an exact, case- and accent-insensitive match. See [Field normalization](/guide/reference/normalization/filters#exact-match-syntax).", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the enriched company HQ country code", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 3, "examples": [ 3 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "examples": [ null ], "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "additionalProperties": false } }, "application/x-www-form-urlencoded": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "job": { "description": "Job-level search criteria", "type": "object", "properties": { "title": { "description": "Keywords matched against the job title only (strict role search)", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "description": { "description": "Keywords matched against the job description content", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "ai_keywords": { "description": "Broad theme search across title, description, skills, responsibilities, requirements and taxonomies", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "field": { "description": "The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form: accepts any field label.", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "seniority": { "description": "The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } } }, "additionalProperties": false }, "employment_type": { "description": "The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } } }, "additionalProperties": false }, "work_arrangement": { "description": "Where the work is performed: on-site, hybrid, or remote.", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } } }, "additionalProperties": false }, "location": { "description": "Job location (not company HQ).", "type": "object", "properties": { "city": { "description": "Job location city (exact, case/accent-insensitive)", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the job location country", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false }, "date_posted": { "description": "Only jobs posted within the last N days", "type": "object", "properties": { "last_days": { "type": "integer", "minimum": 1, "maximum": 3650, "examples": [ 30 ] } }, "required": [ "last_days" ], "additionalProperties": false }, "min_per_company": { "default": 0, "examples": [ 0 ], "description": "Only return companies with at least this many matching jobs (max 25). 0 = unset.", "type": "number", "minimum": 0, "maximum": 25 } }, "additionalProperties": false }, "company": { "description": "Company-level firmographic criteria (enriched from the internal company record)", "type": "object", "properties": { "is_agency": { "description": "true = only recruitment/staffing agencies, false = exclude confirmed agencies, null/omitted = both", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "industry": { "description": "Exact matches on the enriched company's industry", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" ] } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" ] } } }, "additionalProperties": false }, "employee_count": { "description": "Range search on the enriched company's headcount. 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 } }, "additionalProperties": false }, "size": { "description": "Exact matches on the enriched company's size bucket", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "51-200", "201-500" ] ], "type": "array", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } } }, "additionalProperties": false }, "keywords": { "description": "Keywords matched against the enriched company positioning / firmographic text", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "hq": { "description": "Company headquarters (not job location)", "type": "object", "properties": { "city": { "description": "Keywords matched against the enriched company HQ city", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "state": { "description": "Keywords matched against the enriched company HQ state/region", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the enriched company HQ country code", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 3, "examples": [ 3 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "examples": [ null ], "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "additionalProperties": false } }, "multipart/form-data": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "job": { "description": "Job-level search criteria", "type": "object", "properties": { "title": { "description": "Keywords matched against the job title only (strict role search)", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "description": { "description": "Keywords matched against the job description content", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "ai_keywords": { "description": "Broad theme search across title, description, skills, responsibilities, requirements and taxonomies", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "field": { "description": "The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form: accepts any field label.", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "seniority": { "description": "The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } } }, "additionalProperties": false }, "employment_type": { "description": "The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } } }, "additionalProperties": false }, "work_arrangement": { "description": "Where the work is performed: on-site, hybrid, or remote.", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } } }, "additionalProperties": false }, "location": { "description": "Job location (not company HQ).", "type": "object", "properties": { "city": { "description": "Job location city (exact, case/accent-insensitive)", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the job location country", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false }, "date_posted": { "description": "Only jobs posted within the last N days", "type": "object", "properties": { "last_days": { "type": "integer", "minimum": 1, "maximum": 3650, "examples": [ 30 ] } }, "required": [ "last_days" ], "additionalProperties": false }, "min_per_company": { "default": 0, "examples": [ 0 ], "description": "Only return companies with at least this many matching jobs (max 25). 0 = unset.", "type": "number", "minimum": 0, "maximum": 25 } }, "additionalProperties": false }, "company": { "description": "Company-level firmographic criteria (enriched from the internal company record)", "type": "object", "properties": { "is_agency": { "description": "true = only recruitment/staffing agencies, false = exclude confirmed agencies, null/omitted = both", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "industry": { "description": "Exact matches on the enriched company's industry", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" ] } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" ] } } }, "additionalProperties": false }, "employee_count": { "description": "Range search on the enriched company's headcount. 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 } }, "additionalProperties": false }, "size": { "description": "Exact matches on the enriched company's size bucket", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "51-200", "201-500" ] ], "type": "array", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } } }, "additionalProperties": false }, "keywords": { "description": "Keywords matched against the enriched company positioning / firmographic text", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "hq": { "description": "Company headquarters (not job location)", "type": "object", "properties": { "city": { "description": "Keywords matched against the enriched company HQ city", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "state": { "description": "Keywords matched against the enriched company HQ state/region", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the enriched company HQ country code", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "examples": [ [] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 3, "examples": [ 3 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "examples": [ null ], "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Response for status 200", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "company": { "type": "object", "properties": { "linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "linkedin_id": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "about": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "specialties": { "anyOf": [ { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "employees_on_linkedin": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "followers": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "founded_year": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "hq": { "anyOf": [ { "type": "object", "properties": { "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "continent": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "city", "state", "country_code", "country_name", "region", "continent" ], "additionalProperties": false, "examples": [ { "city": "Noida", "state": "Uttar Pradesh", "country_code": "IN", "country_name": "India", "region": "APAC", "continent": "Asia" } ] }, { "type": "null" } ] }, "domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "website": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "linkedin_url", "linkedin_id", "name", "about", "specialties", "industry", "type", "size", "employees_on_linkedin", "followers", "founded_year", "hq", "domain", "website" ], "additionalProperties": false, "examples": [ { "linkedin_url": "https://www.linkedin.com/company/xxx", "linkedin_id": 10509138, "name": "Company Name", "about": "Short company description / about us…", "specialties": [ "graphisme", "conseils communication", "web" ], "industry": "Advertising Services", "type": "Privately Held", "size": "1-10", "employees_on_linkedin": 2, "followers": 58, "founded_year": 2003, "hq": { "city": "Noida", "state": "Uttar Pradesh", "country_code": "IN", "country_name": "India", "region": "APAC", "continent": "Asia" }, "domain": "communication-support.be", "website": "https://www.communication-support.be" } ] }, "matched_jobs": { "type": "number", "description": "Number of jobs matching the filter posted by this company", "examples": [ 3 ] } }, "required": [ "company", "matched_jobs" ], "additionalProperties": false } }, "results_length": { "type": "number", "examples": [ 3 ] }, "max_results": { "type": "number", "examples": [ 3 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "examples": [ null ] }, "fair_usage": { "type": "object", "description": "Record usage, rate limit, and tracing data for this request.", "properties": { "records_used": { "type": "number", "description": "Records this request consumed, after reconciliation against the results actually returned.", "examples": [ 3 ] }, "records_remaining": { "type": "number", "description": "Records left on the plan after this request.", "examples": [ 9913547 ] }, "next_reset_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "When the record balance resets.", "examples": [ "2026-09-29T10:25:23.155Z" ] }, "rate_limit": { "type": "object", "description": "Absent on endpoints that are not rate limited.", "properties": { "requests_per_second": { "type": "number", "description": "Requests this API key may send per second on this endpoint. Set by your plan.", "examples": [ 10 ] }, "remaining_this_second": { "type": "number", "description": "Requests left in the current one-second window.", "examples": [ 9 ] } }, "required": [ "requests_per_second", "remaining_this_second" ], "additionalProperties": false }, "request_id": { "type": "string", "description": "Quote this id when you contact support.", "examples": [ "019bae09-0055-7441-b2ea-16086e499219" ] } }, "required": [ "records_used", "records_remaining", "next_reset_at", "request_id" ], "additionalProperties": false } }, "required": [ "results", "results_length", "max_results", "cursor" ], "additionalProperties": false }, "example": { "results": [ { "company": { "linkedin_url": "https://www.linkedin.com/company/teamforce-labour-ltd", "linkedin_id": 3101649, "name": "Teamforce Labour Limited", "about": "Teamforce is the trusted skilled labour provider to many of the UK's leading contractors across the Construction, Civil Engineering, Rail/ Safety Critical, Power & Utilities, and Tunnelling sectors. \n\nTeamforce is a family-run business. Gerry McCarthy founded the company. His family, all of whom worked in the construction industry before joining Teamforce, are heavily involved in every facet of the business.\n\nWe are known for delivering on our promise and our high service standards. We find the right labour with the proper qualifications within the required timeframe.\n \nAll our operatives are highly qualified. We proactively support and develop them, ensuring their skills are up-to-date and in line with the fast-changing demands of the UK construction landscape.", "specialties": [ "civil engineering", "tunneling", "rail", "high end residential", "recruitment", "trades & labour", "carpentry", "brickwork", "maintenance", "paint & decorating", "logistics", "site setup" ], "industry": "Construction", "type": "Self-Owned", "size": "201-500", "employees_on_linkedin": 41, "followers": 4691, "founded_year": null, "hq": { "city": "Borehamwood", "state": "Hertfordshire", "country_code": "GB", "country_name": "United Kingdom", "region": "EMEA", "continent": "Europe" }, "domain": "teamforcelabour.co.uk", "website": "https://www.teamforcelabour.co.uk" }, "matched_jobs": 88 }, { "company": { "linkedin_url": "https://www.linkedin.com/company/giant-consultingit", "linkedin_id": 80079849, "name": "GIANT Consulting 🌐", "about": "Des consultants spécialisés au service de vos projets. \n\nUne réelle expertise sur toutes vos problématiques informatiques. \n\nDes personnalités incroyables qui sauront mettre leurs compétences à votre disposition pour mener à bien leurs missions.", "specialties": null, "industry": "IT Services and IT Consulting", "type": "Privately Held", "size": "51-200", "employees_on_linkedin": 60, "followers": 3241, "founded_year": 2021, "hq": { "city": "Lyon", "state": "Rhone-Alpes", "country_code": "FR", "country_name": "France", "region": "EMEA", "continent": "Europe" }, "domain": "giant-switzerland.ch", "website": "https://www.giant-switzerland.ch" }, "matched_jobs": 4 }, { "company": { "linkedin_url": "https://www.linkedin.com/company/remobi", "linkedin_id": 91673050, "name": "Remobi", "about": "Remobi accelerates software delivery with world-class nearshore experts. \n\nWe partner with businesses across Europe and North America, extending their engineering capability and rapidly improving the quality and time-to-market of product delivery. \n\nAt the heart of Remobi lies our engineers. Seasoned experts tightly integrated into our customers’ business and wrapped in a delivery model that drives project success. \n\nWith a decade of experience, we deliver value at speed. \n\n_______________________\n\nOur model is built around a unique community of highly experienced consultants. \n\nLocated in carefully selected nearshore locations where expertise is high but operating costs lower, they bring a wealth of experience, are available quickly and are productive at speed. \n\nWe wrap this in a robust agile delivery model that ensures project governance, and we invest heavily in our engineers, through training, support and mentoring. \n\nTogether, our delivery model and community create unique value to our customers - The Remobi Way. ", "specialties": null, "industry": "Technology, Information and Internet", "type": "Privately Held", "size": "51-200", "employees_on_linkedin": 42, "followers": null, "founded_year": 2021, "hq": { "city": "London", "state": null, "country_code": "GB", "country_name": "United Kingdom", "region": "EMEA", "continent": "Europe" }, "domain": "remobi.co", "website": "https://www.remobi.co" }, "matched_jobs": 3 } ], "results_length": 3, "max_results": 3, "cursor": "eyJhIjp7ImNvbXBhbnkiOiIwMTllYWQ2ZS1mOTg3LTc2NGQtYTg5ZC1lYjY2MDMzMzgxMDgifSwibyI6M30.U6EmPspVbo6YRpF42UhNJCSxZV11MoO65GQXQ8JLYXI", "fair_usage": { "records_used": 3, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. job.seniority.include[0]: Invalid value \"senior\". Allowed values: \"0-2\", \"2-5\", \"5-10\", \"10+\".", "errors": [ { "field": "job.seniority.include[0]", "message": "Invalid value \"senior\". Allowed values: \"0-2\", \"2-5\", \"5-10\", \"10+\"." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } }, "operationId": "postV2CompanyTamByJobs" } }, "/v2/company/tam-by-people": { "post": { "summary": "TAM By People", "description": "Returns the distinct companies whose current employees match the people and firmographic filters (deduplicated), each with its matched-people count. Takes the same input as [Find People](/api-reference/people-search/find-people). Optional people.min_per_company floors that count; when it filters heavily, a page may be partial, so keep paging until cursor is null. Cost: 1 record per result (max = max_results)", "tags": [ "Company Search" ], "operationId": "postV2CompanyTamByPeople", "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company": { "description": "Company search criteria", "type": "object", "properties": { "linkedin_url": { "description": "Exact matches for the LinkedIn URL of the company, to look for people in the company", "type": "array", "items": { "type": "string", "examples": [ "https://www.linkedin.com/company/blitz-api" ] }, "maxItems": 50 }, "name": { "description": "Keywords searched in the company name", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "industry": { "description": "Exact matches for the industry search. `Unknown` matches a company with no industry on file, and a person with no company: in `include` it is added to the listed industries, in `exclude` it drops them.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "IT Services and IT Consulting" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } } }, "additionalProperties": false }, "type": { "description": "Exact matches for the company type search", "type": "object", "properties": { "include": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Educational", "Educational Institution", "Government Agency", "Nonprofit", "Partnership", "Privately Held", "Public Company", "Self-Employed", "Self-Owned", "Sole Proprietorship" ] } }, "exclude": { "default": [], "examples": [ [ "Nonprofit", "Partnership" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Educational", "Educational Institution", "Government Agency", "Nonprofit", "Partnership", "Privately Held", "Public Company", "Self-Employed", "Self-Owned", "Sole Proprietorship" ] } } }, "additionalProperties": false }, "employee_range": { "default": [], "examples": [ [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] ], "description": "Exact matches for the employee range search", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } }, "employee_count": { "description": "Range search on the company's employee count (the `employees_on_linkedin` value returned in results)", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 980000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 } }, "additionalProperties": false }, "min_linkedin_followers": { "default": 0, "examples": [ 0 ], "description": "Minimum number of LinkedIn followers", "type": "number", "minimum": 0, "maximum": 10000000 }, "revenue": { "description": "Range search for company revenue (USD). Matches companies whose revenue band overlaps the requested range. 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 9007199254740991 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "naics_code": { "description": "Exact matches for NAICS codes", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "541511" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "sic_code": { "description": "Exact matches for SIC codes", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "7372" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "mx": { "description": "Mail provider of the company, from the MX records of its domains. Companies with no MX data are never matched by `include` and `exclude` never drops them, unless you use `any`.", "type": "object", "properties": { "provider": { "description": "Known mail providers, such as `google` or `microsoft`. A company matches when any of its domains uses the provider. `any` stands for every provider: in `include` it keeps companies with MX data, in `exclude` it keeps companies with no MX data. Use `include: [\"any\"], exclude: [\"google\"]` for companies with MX data that do not use Google.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "google" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "any", "google", "microsoft", "zoho", "godaddy", "proofpoint", "mimecast", "barracuda", "cloudflare", "ionos", "hostinger", "namecheap", "fastmail", "proton", "strato", "ovh", "siteground", "opensrs", "one_com", "tencent", "titan", "20i", "rackspace", "alibaba", "open_xchange", "infomaniak", "jimdo", "netease", "gandi", "register_it", "hetzner", "yahoo", "amazon", "yandex", "locaweb", "uol_host", "fasthosts", "kinghost", "t_online", "hostopia", "united_domains", "hostpoint", "mijndomein", "icloud", "reg123", "mailhostbox", "transip", "natro", "names_co_uk", "intermedia", "hostnet", "aruba", "loopia", "netcup", "lolipop", "simply", "domeneshop", "hornetsecurity", "mailchannels", "appriver", "trendmicro", "spamexperts", "cisco", "sophos", "mesh", "mailinblack" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "any", "google", "microsoft", "zoho", "godaddy", "proofpoint", "mimecast", "barracuda", "cloudflare", "ionos", "hostinger", "namecheap", "fastmail", "proton", "strato", "ovh", "siteground", "opensrs", "one_com", "tencent", "titan", "20i", "rackspace", "alibaba", "open_xchange", "infomaniak", "jimdo", "netease", "gandi", "register_it", "hetzner", "yahoo", "amazon", "yandex", "locaweb", "uol_host", "fasthosts", "kinghost", "t_online", "hostopia", "united_domains", "hostpoint", "mijndomein", "icloud", "reg123", "mailhostbox", "transip", "natro", "names_co_uk", "intermedia", "hostnet", "aruba", "loopia", "netcup", "lolipop", "simply", "domeneshop", "hornetsecurity", "mailchannels", "appriver", "trendmicro", "spamexperts", "cisco", "sophos", "mesh", "mailinblack" ] } } }, "additionalProperties": false } }, "additionalProperties": false }, "web_traffic": { "description": "Range search for total monthly web traffic (visits). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2147483647 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2147483647 } }, "additionalProperties": false }, "ad_spend": { "description": "Range search for monthly Google ad spend (USD). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 } }, "additionalProperties": false }, "total_funding": { "description": "Range search for total funding amount (USD). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 } }, "additionalProperties": false }, "last_funding_amount": { "description": "Range search for the last funding round amount (USD). 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000000 } }, "additionalProperties": false }, "last_funding_year": { "description": "Range search for the year of the last funding round. 0 = unset, otherwise 1800 to 2026.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2026 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 2026 } }, "additionalProperties": false }, "last_funding_type": { "description": "Exact matches for the last funding round type", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Series A" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Series unknown", "Pre seed", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E-J", "Grant", "Angel", "Private equity", "Debt financing", "Non equity assistance", "Post IPO equity", "Undisclosed", "Post IPO debt", "Product crowdfunding", "Equity crowdfunding", "Corporate round", "Convertible note", "Secondary market", "Initial coin offering", "Post IPO secondary" ] } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Series unknown", "Pre seed", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E-J", "Grant", "Angel", "Private equity", "Debt financing", "Non equity assistance", "Post IPO equity", "Undisclosed", "Post IPO debt", "Product crowdfunding", "Equity crowdfunding", "Corporate round", "Convertible note", "Secondary market", "Initial coin offering", "Post IPO secondary" ] } } }, "additionalProperties": false }, "lead_investors": { "description": "Keywords searched in lead investor names", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Sequoia" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "keywords": { "description": "Keywords searched across the company description, specialties, NAICS/SIC descriptions, and Crunchbase/G2 categories. A phrase matches a company if all its tokens are found within any one of those fields.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Tech" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [ "Finance", "Marketing" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "founded_year": { "description": "Range search for the year the company was founded", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000000 } }, "additionalProperties": false }, "hq": { "description": "Location of the headquarters of the company", "type": "object", "properties": { "city": { "description": "Keywords searched to find the headquarters city of the company", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "City" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [ "New" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "state": { "description": "Keywords searched to find the headquarters state/province of the company", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "California" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [ "Texas" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "country_code": { "default": [], "examples": [ [] ], "description": "Exact matches for the country code of the headquarters", "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "continent": { "default": [], "examples": [ [] ], "description": "Exact matches for the continent of the headquarters", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Africa", "Antarctica", "Asia", "Europe", "North America", "Oceania", "South America" ] } }, "sales_region": { "default": [], "examples": [ [] ], "description": "Exact matches for the sales region of the headquarters", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "NORAM", "LATAM", "EMEA", "APAC" ] } } }, "additionalProperties": false } }, "additionalProperties": false }, "people": { "description": "People search criteria for company matching", "type": "object", "properties": { "linkedin_url": { "description": "Exact matches for the LinkedIn URL of the person, to find specific people", "type": "array", "items": { "type": "string", "examples": [ "https://www.linkedin.com/in/antoine-blitz-5581b7373" ] }, "maxItems": 50 }, "job_title": { "description": "Find at least one person with the given job title in the company. Values match as a keyword search by default; wrap a value in square brackets (`\"[CEO]\"`) to require an exact, case- and accent-insensitive match. See [Field normalization](/guide/reference/normalization/filters#exact-match-syntax).", "type": "object", "properties": { "include_linkedin_headline": { "default": false, "examples": [ false ], "description": "Whether to include the LinkedIn headline in the job_title search", "type": "boolean" }, "include": { "default": [], "examples": [ [ "Software Engineer" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [ "CTO" ] ], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "job_function": { "default": [], "examples": [ [ "Advertising & Marketing" ] ], "description": "Exact matches for the job function search", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Advertising & Marketing", "Art, Culture and Creative Professionals", "Construction", "Customer/Client Service", "Education", "Engineering", "Finance & Accounting", "General Business & Management", "Healthcare & Human Services", "Human Resources", "Information Technology", "Legal", "Manufacturing & Production", "Operations", "Other", "Public Administration & Safety", "Purchasing", "Research & Development", "Sales & Business Development", "Science", "Supply Chain & Logistics", "Writing/Editing" ] } }, "job_level": { "examples": [ [ "VP", "Director" ] ], "description": "Exact matches for the job level search", "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "C-Team", "Director", "Manager", "Other", "Staff", "VP" ] } }, "min_connections": { "default": 0, "examples": [ 500 ], "description": "Minimum number of LinkedIn connections to find", "type": "number", "minimum": 0, "maximum": 500 }, "is_recent_hire": { "default": false, "examples": [ false ], "description": "Only people with a job that started in the last 90 days. The job must also match the other job and company filters. A job with no start date never matches.", "type": "boolean" }, "location": { "description": "Location of the people to find", "type": "object", "properties": { "city": { "description": "Keywords searched to find the city where the person is based", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Paris", "London" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } }, "exclude": { "default": [], "examples": [ [ "Remote" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1 } } }, "additionalProperties": false }, "country_code": { "default": [], "examples": [ [ "FR", "GB" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 3 } }, "continent": { "default": [], "examples": [ [ "Europe" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Africa", "Antarctica", "Asia", "Europe", "North America", "Oceania", "South America" ] } }, "sales_region": { "default": [], "examples": [ [ "EMEA" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "NORAM", "LATAM", "EMEA", "APAC" ] } } }, "additionalProperties": false }, "education": { "description": "Education filter for the person. Phrases are matched against each education entry independently: tokens within a phrase must co-occur inside a single entry (school, degree, dates), so a phrase like \"Stanford 2025\" matches a person who studied at Stanford ending in 2025, not someone with separate Stanford and 2025 entries.", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "Stanford CS 2025", "MIT" ] ], "description": "Phrases matched against education entries. Tokens must co-occur within a single entry, so wrap the year in the phrase (e.g. \"Stanford 2025\") to correlate school and year. Token order is not significant (\"Stanford CS\" matches \"CS Stanford\"). Multiple phrases are OR-ed.", "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "examples": [ [ "Bootcamp" ] ], "description": "Phrases excluded from education entries: any person with an entry matching one of these phrases is filtered out.", "maxItems": 50, "type": "array", "items": { "type": "string" } }, "start_year": { "description": "Range search for the year an education entry started. 0 = unset. Applies to the same entry as include; an entry with no start year never matches a bound.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 2016 ], "type": "integer", "minimum": 0, "maximum": 2100 }, "max": { "default": 0, "examples": [ 2020 ], "type": "integer", "minimum": 0, "maximum": 2100 } }, "additionalProperties": false }, "end_year": { "description": "Range search for the year an education entry ended (graduation year). 0 = unset. Applies to the same entry as include; an entry with no end year never matches a bound.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 2018 ], "type": "integer", "minimum": 0, "maximum": 2100 }, "max": { "default": 0, "examples": [ 2022 ], "type": "integer", "minimum": 0, "maximum": 2100 } }, "additionalProperties": false } }, "additionalProperties": false }, "min_per_company": { "default": 0, "examples": [ 0 ], "description": "Only return companies with at least this many matching employees (max 25). 0 = unset.", "type": "number", "minimum": 0, "maximum": 25 } }, "additionalProperties": false }, "max_results": { "default": 10, "examples": [ 10 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "examples": [ null ], "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "additionalProperties": false, "example": { "company": { "linkedin_url": [], "name": { "include": [], "exclude": [] }, "industry": { "include": [], "exclude": [] }, "type": { "include": [], "exclude": [] }, "employee_range": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ], "employee_count": { "min": 1, "max": 0 }, "min_linkedin_followers": 1, "revenue": { "min": 0, "max": 0 }, "naics_code": { "include": [], "exclude": [] }, "sic_code": { "include": [], "exclude": [] }, "web_traffic": { "min": 0, "max": 0 }, "ad_spend": { "min": 0, "max": 0 }, "total_funding": { "min": 0, "max": 0 }, "last_funding_amount": { "min": 0, "max": 0 }, "last_funding_year": { "min": 0, "max": 0 }, "last_funding_type": { "include": [], "exclude": [] }, "lead_investors": { "include": [], "exclude": [] }, "keywords": { "include": [], "exclude": [] }, "founded_year": { "min": 0, "max": 0 }, "hq": { "city": { "include": [], "exclude": [] }, "country_code": [], "continent": [], "sales_region": [] } }, "people": { "job_title": { "include_linkedin_headline": false, "include": [], "exclude": [] }, "job_function": [], "job_level": [], "min_connections": 500, "location": { "city": { "include": [], "exclude": [] }, "country_code": [ "US" ], "continent": [], "sales_region": [] }, "education": { "include": [], "exclude": [] } }, "max_results": 3, "cursor": null } } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "company": { "type": "object", "properties": { "linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "linkedin_id": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "about": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "specialties": { "anyOf": [ { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "employees_on_linkedin": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "followers": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "founded_year": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "hq": { "anyOf": [ { "type": "object", "properties": { "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "continent": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "city", "state", "country_code", "country_name", "region", "continent" ], "additionalProperties": false, "examples": [ { "city": "Noida", "state": "Uttar Pradesh", "country_code": "IN", "country_name": "India", "region": "APAC", "continent": "Asia" } ] }, { "type": "null" } ] }, "domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "website": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "linkedin_url", "linkedin_id", "name", "about", "specialties", "industry", "type", "size", "employees_on_linkedin", "followers", "founded_year", "hq", "domain", "website" ], "additionalProperties": false, "examples": [ { "linkedin_url": "https://www.linkedin.com/company/xxx", "linkedin_id": 10509138, "name": "Company Name", "about": "Short company description / about us…", "specialties": [ "graphisme", "conseils communication", "web" ], "industry": "Advertising Services", "type": "Privately Held", "size": "1-10", "employees_on_linkedin": 2, "followers": 58, "founded_year": 2003, "hq": { "city": "Noida", "state": "Uttar Pradesh", "country_code": "IN", "country_name": "India", "region": "APAC", "continent": "Asia" }, "domain": "communication-support.be", "website": "https://www.communication-support.be" } ] }, "matched_people": { "type": "number", "description": "Number of current employees matching the filter at this company", "examples": [ 3 ] } }, "required": [ "company", "matched_people" ], "additionalProperties": false } }, "results_length": { "type": "number", "examples": [ 3 ] }, "max_results": { "type": "number", "examples": [ 3 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "examples": [ null ] }, "fair_usage": { "type": "object", "description": "Record usage, rate limit, and tracing data for this request.", "properties": { "records_used": { "type": "number", "description": "Records this request consumed, after reconciliation against the results actually returned.", "examples": [ 3 ] }, "records_remaining": { "type": "number", "description": "Records left on the plan after this request.", "examples": [ 9913547 ] }, "next_reset_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "When the record balance resets.", "examples": [ "2026-09-29T10:25:23.155Z" ] }, "rate_limit": { "type": "object", "description": "Absent on endpoints that are not rate limited.", "properties": { "requests_per_second": { "type": "number", "description": "Requests this API key may send per second on this endpoint. Set by your plan.", "examples": [ 10 ] }, "remaining_this_second": { "type": "number", "description": "Requests left in the current one-second window.", "examples": [ 9 ] } }, "required": [ "requests_per_second", "remaining_this_second" ], "additionalProperties": false }, "request_id": { "type": "string", "description": "Quote this id when you contact support.", "examples": [ "019bae09-0055-7441-b2ea-16086e499219" ] } }, "required": [ "records_used", "records_remaining", "next_reset_at", "request_id" ], "additionalProperties": false } }, "required": [ "results", "results_length", "max_results", "cursor" ], "additionalProperties": false }, "example": { "results": [ { "company": { "linkedin_url": "https://www.linkedin.com/company/google", "linkedin_id": 1441, "name": "Google", "about": "A problem isn\\'t truly solved until it\\'s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone. Check out our career opportunities at goo.gle/3DLEokh", "specialties": [ "mobile", "hardware", "youtube", "machine learning", "artificial intelligence", "software", "search", "apps", "cloud", "online video", "virtual reality", "roid", "ads" ], "industry": "Software Development", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 328177, "followers": 40093219, "founded_year": null, "hq": { "city": "Mountain View", "state": "California", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America" }, "domain": "google.com", "website": "https://www.google.com" }, "matched_people": 42 }, { "company": { "linkedin_url": "https://www.linkedin.com/company/amazon", "linkedin_id": 1586, "name": "Amazon", "about": "Amazon is guided by four principles: customer obsession rather than competitor focus, passion for invention, commitment to operational excellence, and long-term thinking. We are driven by the excitement of building technologies, inventing products, and providing services that change lives. We embrace new ways of doing things, make decisions quickly, and are not afraid to fail. We have the scope and capabilities of a large company, and the spirit and heart of a small one. Together, Amazonians research and develop new technologies from Amazon Web Services to Alexa on behalf of our customers: shoppers, sellers, content creators, and developers around the world. Our mission is to be Earth\\'s most customer-centric company. Our actions, goals, projects, programs, and inventions begin and end with the customer top of mind. You\\'ll also hear us say that at Amazon, it\\'s always \\\"Day 1.\\\" What do we mean? That our approach remains the same as it was on Amazon\\'s very first day - to make smart, fast decisions, stay nimble, invent, and focus on delighting our customers.", "specialties": [ "operations", "internet", "retail", "e-commerce" ], "industry": "Software Development", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 778681, "followers": 35961516, "founded_year": null, "hq": { "city": "Seattle", "state": "Washington", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America" }, "domain": "amazon.com", "website": "https://www.amazon.com" }, "matched_people": 27 }, { "company": { "linkedin_url": "https://www.linkedin.com/company/1337", "linkedin_id": 1337, "name": "Linkedin", "about": "Founded in 2003, LinkedIn connects the world\\'s professionals to make them more productive and successful. With more than 1 billion members worldwide, including executives from every Fortune 500 company, LinkedIn is the world\\'s largest professional network. The company has a diversified business model with revenue coming from Talent Solutions, Marketing Solutions, Sales Solutions and Premium Subscriptions products. Headquartered in Silicon Valley, LinkedIn has offices across the globe.", "specialties": [ "address book", "recruiting", "people search", "group collaboration", "online professional network", "company search", "jobs", "professional identity", "advertising" ], "industry": "Software Development", "type": "Public Company", "size": "10001+", "employees_on_linkedin": 23910, "followers": 32612546, "founded_year": null, "hq": { "city": "Sunnyvale", "state": "California", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America" }, "domain": null, "website": "https://www.linkedin.com" }, "matched_people": 4 } ], "results_length": 3, "max_results": 3, "cursor": "eyJvZmZzZXQiOjN9", "fair_usage": { "records_used": 3, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. people.min_per_company: Must be at most 25 (got 50).", "errors": [ { "field": "people.min_per_company", "message": "Must be at most 25 (got 50)." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/jobs/search": { "post": { "summary": "Search Jobs", "description": "Search job postings across companies by job attributes, location, and company firmographics.", "tags": [ "Job Search" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "job": { "description": "Job-level search criteria", "type": "object", "properties": { "title": { "description": "Keywords matched against the job title only (strict role search). Values match as a keyword search by default; wrap a value in square brackets (`\"[Head of Sales]\"`) to require an exact, case- and accent-insensitive match. See [Field normalization](/guide/reference/normalization/filters#exact-match-syntax).", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" }, "examples": [ [ "Software Engineer" ] ], "example": [ "Software Engineer" ] }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "description": { "description": "Keywords matched against the job description content", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "ai_keywords": { "description": "Broad theme search across title, description, skills, responsibilities, requirements and taxonomies", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "field": { "description": "The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form: accepts any field label.", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "seniority": { "description": "The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] }, "examples": [ [ "2-5", "5-10" ] ], "example": [ "2-5", "5-10" ] }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } } }, "additionalProperties": false }, "employment_type": { "description": "The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] }, "examples": [ [ "FULL_TIME" ] ], "example": [ "FULL_TIME" ] }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } } }, "additionalProperties": false }, "work_arrangement": { "description": "Where the work is performed: on-site, hybrid, or remote.", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } } }, "additionalProperties": false }, "location": { "description": "Job location (not company HQ).", "type": "object", "properties": { "city": { "description": "Job location city (exact, case/accent-insensitive)", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the job location country", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false }, "date_posted": { "description": "Only jobs posted within the last N days", "type": "object", "properties": { "last_days": { "examples": [ 30 ], "type": "integer", "minimum": 1, "maximum": 3650, "example": 30 } }, "required": [ "last_days" ], "additionalProperties": false } }, "additionalProperties": false }, "company": { "description": "Company-level firmographic criteria (enriched from the internal company record)", "type": "object", "properties": { "is_agency": { "description": "true = only recruitment/staffing agencies, false = exclude confirmed agencies, null/omitted = both", "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "examples": [ null ], "example": null }, "industry": { "description": "Exact matches on the enriched company's industry. `Unknown` matches a company with no industry on file, and a job with no company: in `include` it is added to the listed industries, in `exclude` it drops them.", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens", "Unknown" ] } } }, "additionalProperties": false }, "employee_count": { "description": "Range search on the enriched company's headcount. 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 } }, "additionalProperties": false }, "size": { "description": "Exact matches on the enriched company's size bucket", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "51-200", "201-500" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } } }, "additionalProperties": false }, "keywords": { "description": "Keywords matched against the enriched company positioning / firmographic text", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "hq": { "description": "Company headquarters (not job location)", "type": "object", "properties": { "city": { "description": "Keywords matched against the enriched company HQ city. Values match as a keyword search by default; wrap a value in square brackets (`\"[Paris]\"`) to require an exact, case- and accent-insensitive match. See [Field normalization](/guide/reference/normalization/filters#exact-match-syntax).", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "state": { "description": "Keywords matched against the enriched company HQ state/region. Values match as a keyword search by default; wrap a value in square brackets (`\"[California]\"`) to require an exact, case- and accent-insensitive match. See [Field normalization](/guide/reference/normalization/filters#exact-match-syntax).", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the enriched company HQ country code", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 10, "examples": [ 2 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50, "example": 2 }, "cursor": { "default": null, "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ], "examples": [ null ], "example": null } }, "additionalProperties": false } }, "application/x-www-form-urlencoded": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "job": { "description": "Job-level search criteria", "type": "object", "properties": { "title": { "description": "Keywords matched against the job title only (strict role search)", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "description": { "description": "Keywords matched against the job description content", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "ai_keywords": { "description": "Broad theme search across title, description, skills, responsibilities, requirements and taxonomies", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "field": { "description": "The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form: accepts any field label.", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "seniority": { "description": "The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } } }, "additionalProperties": false }, "employment_type": { "description": "The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } } }, "additionalProperties": false }, "work_arrangement": { "description": "Where the work is performed: on-site, hybrid, or remote.", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } } }, "additionalProperties": false }, "location": { "description": "Job location (not company HQ).", "type": "object", "properties": { "city": { "description": "Job location city (exact, case/accent-insensitive)", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the job location country", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false }, "date_posted": { "description": "Only jobs posted within the last N days", "type": "object", "properties": { "last_days": { "examples": [ 30 ], "type": "integer", "minimum": 1, "maximum": 3650, "example": 30 } }, "additionalProperties": false } }, "additionalProperties": false }, "company": { "description": "Company-level firmographic criteria (enriched from the internal company record)", "type": "object", "properties": { "is_agency": { "description": "true = only recruitment/staffing agencies, false = exclude confirmed agencies, null/omitted = both", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "industry": { "description": "Exact matches on the enriched company's industry", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" ] } } }, "additionalProperties": false }, "employee_count": { "description": "Range search on the enriched company's headcount. 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 } }, "additionalProperties": false }, "size": { "description": "Exact matches on the enriched company's size bucket", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "51-200", "201-500" ] ], "type": "array", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } } }, "additionalProperties": false }, "keywords": { "description": "Keywords matched against the enriched company positioning / firmographic text", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "hq": { "description": "Company headquarters (not job location)", "type": "object", "properties": { "city": { "description": "Keywords matched against the enriched company HQ city", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "state": { "description": "Keywords matched against the enriched company HQ state/region", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the enriched company HQ country code", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 10, "examples": [ 10 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "additionalProperties": false } }, "multipart/form-data": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "job": { "description": "Job-level search criteria", "type": "object", "properties": { "title": { "description": "Keywords matched against the job title only (strict role search)", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "description": { "description": "Keywords matched against the job description content", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "ai_keywords": { "description": "Broad theme search across title, description, skills, responsibilities, requirements and taxonomies", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "field": { "description": "The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form: accepts any field label.", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "seniority": { "description": "The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } } }, "additionalProperties": false }, "employment_type": { "description": "The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } } }, "additionalProperties": false }, "work_arrangement": { "description": "Where the work is performed: on-site, hybrid, or remote.", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } } }, "additionalProperties": false }, "location": { "description": "Job location (not company HQ).", "type": "object", "properties": { "city": { "description": "Job location city (exact, case/accent-insensitive)", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the job location country", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false }, "date_posted": { "description": "Only jobs posted within the last N days", "type": "object", "properties": { "last_days": { "examples": [ 30 ], "type": "integer", "minimum": 1, "maximum": 3650, "example": 30 } }, "additionalProperties": false } }, "additionalProperties": false }, "company": { "description": "Company-level firmographic criteria (enriched from the internal company record)", "type": "object", "properties": { "is_agency": { "description": "true = only recruitment/staffing agencies, false = exclude confirmed agencies, null/omitted = both", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "industry": { "description": "Exact matches on the enriched company's industry", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accessible Hardware Manufacturing", "Accommodation and Food Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture; Construction; Mining Machinery Manufacturing", "Airlines and Aviation", "Airlines/Aviation", "Air; Water; and Waste Program Management", "Alternative Dispute Resolution", "Alternative Fuel Vehicle Manufacturing", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel and Fashion", "Apparel Manufacturing", "Appliances; Electrical; and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artificial Rubber and Synthetic Fiber Manufacturing", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation and Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars; Taverns; and Nightclubs", "Bed-and-Breakfasts; Hostels; Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers; Tanks; and Shipping Container Manufacturing", "Book and Periodical Publishing", "Book Publishing", "Breweries", "Broadcast Media", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Cable and Satellite Programming", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Chemicals", "Child Day Care Services", "Chiropractors", "Circuses and Magic Shows", "Civic and Social Organization", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting; Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Commercial Real Estate", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer and Network Security", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computers and Electronics Manufacturing", "Computer Software", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Correctional Institutions", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Cutlery and Handtool Manufacturing", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Death Care Services", "Defense and Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "E-learning", "E-Learning Providers", "Electrical and Electronic Manufacturing", "Electrical Equipment Manufacturing", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission; Control; and Distribution", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Energy Technology", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Office", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Family Planning Centers", "Farming", "Farming; Ranching; Forestry", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Fishery", "Flight Training", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverages", "Food and Beverage Services", "Food Production", "Footwear and Leather Goods Repair", "Footwear Manufacturing", "Forestry and Logging", "Fossil Fuel Electric Power Generation", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fuel Cell Manufacturing", "Fundraising", "Funds and Trusts", "Funeral Services", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling and Casinos", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass; Ceramics and Concrete", "Glass; Ceramics and Concrete Manufacturing", "Glass Product Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "Health and Human Services", "Health; Wellness and Fitness", "Higher Education", "Highway; Street; and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospital and Health Care", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household and Institutional Furniture Manufacturing", "Household Appliance Manufacturing", "Household Services", "Housing and Community Development", "Housing Programs", "Human Resources", "Human Resources Services", "HVAC and Refrigeration Equipment Manufacturing", "Hydroelectric Power Generation", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance and Employee Benefit Funds", "Insurance Carriers", "Interior Design", "International Affairs", "International Trade and Development", "Internet", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Interurban and Rural Bus Services", "Investment Advice", "Investment Banking", "Investment Management", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Janitorial Services", "Judiciary", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure; Travel and Tourism", "Libraries", "Lime and Gypsum Products Manufacturing", "Loan Brokers", "Logistics and Supply Chain", "Luxury Goods and Jewelry", "Machinery", "Machinery Manufacturing", "Magnetic and Optical Media Manufacturing", "Management Consulting", "Manufacturing", "Maritime", "Maritime Transportation", "Marketing and Advertising", "Marketing Services", "Market Research", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical Or Industrial Engineering", "Media and Telecommunications", "Media Production", "Medical and Diagnostic Laboratories", "Medical Device", "Medical Equipment Manufacturing", "Medical Practice", "Medical Practices", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve; Ball; and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military", "Military and International Affairs", "Mining", "Mining and Metals", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Games", "Mobile Gaming Apps", "Motion Pictures and Film", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies; Videos; and Sound", "Museums", "Museums and Institutions", "Museums; Historical Sites; and Zoos", "Music", "Musicians", "Nanotechnology", "Nanotechnology Research", "Natural Gas Distribution", "Natural Gas Extraction", "Newspaper Publishing", "Newspapers", "Nonmetallic Mineral Mining", "Non-profit Organization Management", "Non-profit Organizations", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Coal Product Manufacturing", "Oil and Energy", "Oil and Gas", "Oil Extraction", "Oil; Gas; and Mining", "Online and Mail Order Retail", "Online Audio and Video Media", "Online Media", "Operations Consulting", "Optometrists", "Other", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Package/Freight Delivery", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint; Coating; and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Parts Distribution", "Pension Funds", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal and Laundry Services", "Personal Care Product Manufacturing", "Personal Care Services", "Pet Services", "Pharmaceutical Manufacturing", "Pharmaceuticals", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical; Occupational and Speech Therapists", "Physicians", "Pipeline Transportation", "Plastics", "Plastics and Rubber Product Manufacturing", "Plastics Manufacturing", "Political Organization", "Political Organizations", "Postal Services", "Primary and Secondary Education", "Primary Metal Manufacturing", "Primary/Secondary Education", "Printing", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications", "Public Relations and Communications Services", "Public Safety", "Public Works", "Publishing", "Racetracks", "Radio and Television Broadcasting", "Railroad Equipment Manufacturing", "Railroad Manufacture", "Rail Transportation", "Ranching", "Ranching and Fisheries", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Recreational Facilities and Services", "Regenerative Design", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables and Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances; Electrical; and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials and Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Robot Manufacturing", "Rubber Products Manufacturing", "Satellite Telecommunications", "Savings Institutions", "School and Employee Bus Services", "Seafood Product Manufacturing", "Secretarial Schools", "Securities and Commodity Exchanges", "Security and Investigations", "Security Guards and Patrol Services", "Security Systems Services", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Skiing Facilities", "Smart Meter Manufacturing", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports", "Sports and Recreation Instruction", "Sports Teams and Clubs", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Supermarkets", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology; Information and Internet", "Technology; Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Textiles", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation; Logistics; Supply Chain and Storage", "Transportation Programs", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water; Waste; Steam; and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances; Electrical; and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware; Plumbing; Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Photography Equipment and Supplies", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless", "Wireless Services", "Women\\\\'s Handbag Manufacturing", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" ] } } }, "additionalProperties": false }, "employee_count": { "description": "Range search on the enriched company's headcount. 0 = unset.", "type": "object", "properties": { "min": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 }, "max": { "default": 0, "examples": [ 0 ], "type": "number", "minimum": 0, "maximum": 1000000 } }, "additionalProperties": false }, "size": { "description": "Exact matches on the enriched company's size bucket", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "51-200", "201-500" ] ], "type": "array", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } } }, "additionalProperties": false }, "keywords": { "description": "Keywords matched against the enriched company positioning / firmographic text", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "hq": { "description": "Company headquarters (not job location)", "type": "object", "properties": { "city": { "description": "Keywords matched against the enriched company HQ city", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "state": { "description": "Keywords matched against the enriched company HQ state/region", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the enriched company HQ country code", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 10, "examples": [ 10 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Response for status 200", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "total_results": { "type": "number", "examples": [ 100 ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "date_posted": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ai_summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "location": { "type": "object", "properties": { "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false } }, "additionalProperties": false, "examples": [ { "date_posted": "2026-07-08 23:00:07+02", "title": "Growth Marketing Manager, SMB Ads", "url": "https://www.linkedin.com/jobs/view/growth-marketing-manager-smb-ads-at-openai-4437309737", "company_name": "OpenAI", "company_linkedin_url": "https://www.linkedin.com/company/openai", "ai_summary": "The Growth Marketing Manager will execute growth experiments across acquisition, activation, lifecycle, and early retention for small business advertisers. They will build campaigns, lifecycle journeys, and various tests to help advertisers achieve their first meaningful spend and retention over time.", "location": { "city": "San Francisco", "country_code": "US" } } ] } }, "results_length": { "type": "number", "examples": [ 3 ] }, "max_results": { "type": "number", "examples": [ 10 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fair_usage": { "type": "object", "description": "Record usage, rate limit, and tracing data for this request.", "properties": { "records_used": { "type": "number", "description": "Records this request consumed, after reconciliation against the results actually returned.", "examples": [ 3 ] }, "records_remaining": { "type": "number", "description": "Records left on the plan after this request.", "examples": [ 9913547 ] }, "next_reset_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "When the record balance resets.", "examples": [ "2026-09-29T10:25:23.155Z" ] }, "rate_limit": { "type": "object", "description": "Absent on endpoints that are not rate limited.", "properties": { "requests_per_second": { "type": "number", "description": "Requests this API key may send per second on this endpoint. Set by your plan.", "examples": [ 10 ] }, "remaining_this_second": { "type": "number", "description": "Requests left in the current one-second window.", "examples": [ 9 ] } }, "required": [ "requests_per_second", "remaining_this_second" ], "additionalProperties": false }, "request_id": { "type": "string", "description": "Quote this id when you contact support.", "examples": [ "019bae09-0055-7441-b2ea-16086e499219" ] } }, "required": [ "records_used", "records_remaining", "next_reset_at", "request_id" ], "additionalProperties": false } }, "additionalProperties": false, "example": { "total_results": 31787, "results": [ { "date_posted": "2026-07-22 10:52:23.413+02", "title": "Senior Software Engineer", "url": "https://pt.linkedin.com/jobs/view/senior-software-engineer-at-spectrum-it-recruitment-1234567890", "company_name": "Spectrum IT Recruitment", "company_linkedin_url": "https://www.linkedin.com/company/spectrum-it-recruitment", "ai_summary": "Develop and ship core database engine features focusing on performance, resilience, and fault tolerance. Implement low-level C++ codefor query execution, replication, and cost-based optimization.", "location": { "city": null, "country_code": "PT" } }, { "date_posted": "2026-07-22 10:43:38+02", "title": "Software engineer - Generative AI Python", "url": "https://es.linkedin.com/jobs/view/software-engineer-generative-ai-python-at-altia-1234567891", "company_name": "Altia", "company_linkedin_url": "https://www.linkedin.com/company/altia-sa", "ai_summary": "Design and optimize backend services and APIs to ensure reliability and efficiency. Integrate advanced AI capabilities and intelligent platforms into cloud-based infrastructures.", "location": { "city": "Madrid", "country_code": "ES" } } ], "results_length": 2, "max_results": 2, "cursor": "eyJzIjpbMTcwMDAwMDAwMDAwMDAwMCwxMjM0NTY3ODkwXSwibyI6Mn0.ZXhhbXBsZS1jdXJzb3Itc2lnbmF0dXJlLW5vdC1yZWFs", "fair_usage": { "records_used": 2, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. job.title: Unknown field \"includes\". Did you mean \"include\"?", "errors": [ { "field": "job.title", "message": "Unknown field \"includes\". Did you mean \"include\"?" } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Service temporarily unavailable, please try again later" } } } } } }, "operationId": "postV2JobsSearch" } }, "/v2/jobs/company": { "post": { "summary": "Search Company Jobs", "description": "List job postings at a single company from its LinkedIn company URL, with optional job-level filters.", "tags": [ "Job Search" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "company_linkedin_url": { "type": "string", "minLength": 1, "description": "LinkedIn company URL. Results are scoped to this single company.", "examples": [ "https://www.linkedin.com/company/openai" ], "example": "https://www.linkedin.com/company/openai" }, "job": { "description": "Job-level search criteria", "type": "object", "properties": { "title": { "description": "Keywords matched against the job title only (strict role search). Values match as a keyword search by default; wrap a value in square brackets (`\"[Head of Sales]\"`) to require an exact, case- and accent-insensitive match. See [Field normalization](/guide/reference/normalization/filters#exact-match-syntax).", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" }, "examples": [ [ "Software Engineer" ] ], "example": [ "Software Engineer" ] }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "description": { "description": "Keywords matched against the job description content", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "ai_keywords": { "description": "Broad theme search across title, description, skills, responsibilities, requirements and taxonomies", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "field": { "description": "The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form: accepts any field label.", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "seniority": { "description": "The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] }, "examples": [ [ "2-5", "5-10" ] ], "example": [ "2-5", "5-10" ] }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } } }, "additionalProperties": false }, "employment_type": { "description": "The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] }, "examples": [ [ "FULL_TIME" ] ], "example": [ "FULL_TIME" ] }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } } }, "additionalProperties": false }, "work_arrangement": { "description": "Where the work is performed: on-site, hybrid, or remote.", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } } }, "additionalProperties": false }, "location": { "description": "Job location (not company HQ).", "type": "object", "properties": { "city": { "description": "Job location city (exact, case/accent-insensitive)", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the job location country", "type": "object", "properties": { "include": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false }, "date_posted": { "description": "Only jobs posted within the last N days", "type": "object", "properties": { "last_days": { "examples": [ 30 ], "type": "integer", "minimum": 1, "maximum": 3650, "example": 30 } }, "required": [ "last_days" ], "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 10, "examples": [ 2 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50, "example": 2 }, "cursor": { "default": null, "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ], "examples": [ null ], "example": null } }, "required": [ "company_linkedin_url" ], "additionalProperties": false } }, "application/x-www-form-urlencoded": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "company_linkedin_url": { "type": "string", "minLength": 1, "description": "LinkedIn company URL. Results are scoped to this single company.", "examples": [ "https://www.linkedin.com/company/openai" ], "example": "https://www.linkedin.com/company/openai" }, "job": { "description": "Job-level search criteria", "type": "object", "properties": { "title": { "description": "Keywords matched against the job title only (strict role search)", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "description": { "description": "Keywords matched against the job description content", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "ai_keywords": { "description": "Broad theme search across title, description, skills, responsibilities, requirements and taxonomies", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "field": { "description": "The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form: accepts any field label.", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "seniority": { "description": "The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } } }, "additionalProperties": false }, "employment_type": { "description": "The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } } }, "additionalProperties": false }, "work_arrangement": { "description": "Where the work is performed: on-site, hybrid, or remote.", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } } }, "additionalProperties": false }, "location": { "description": "Job location (not company HQ).", "type": "object", "properties": { "city": { "description": "Job location city (exact, case/accent-insensitive)", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the job location country", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false }, "date_posted": { "description": "Only jobs posted within the last N days", "type": "object", "properties": { "last_days": { "examples": [ 30 ], "type": "integer", "minimum": 1, "maximum": 3650, "example": 30 } }, "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 10, "examples": [ 10 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "required": [ "company_linkedin_url" ], "additionalProperties": false } }, "multipart/form-data": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "company_linkedin_url": { "type": "string", "minLength": 1, "description": "LinkedIn company URL. Results are scoped to this single company.", "examples": [ "https://www.linkedin.com/company/openai" ], "example": "https://www.linkedin.com/company/openai" }, "job": { "description": "Job-level search criteria", "type": "object", "properties": { "title": { "description": "Keywords matched against the job title only (strict role search)", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "description": { "description": "Keywords matched against the job description content", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "ai_keywords": { "description": "Broad theme search across title, description, skills, responsibilities, requirements and taxonomies", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "field": { "description": "The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form: accepts any field label.", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "seniority": { "description": "The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } } }, "additionalProperties": false }, "employment_type": { "description": "The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } } }, "additionalProperties": false }, "work_arrangement": { "description": "Where the work is performed: on-site, hybrid, or remote.", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } } }, "additionalProperties": false }, "location": { "description": "Job location (not company HQ).", "type": "object", "properties": { "city": { "description": "Job location city (exact, case/accent-insensitive)", "type": "object", "properties": { "include": { "default": [], "type": "array", "items": { "type": "string" } }, "exclude": { "default": [], "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "country_code": { "description": "Exact matches (ISO-3166 alpha-2) on the job location country", "type": "object", "properties": { "include": { "default": [], "examples": [ [ "FR", "GB" ] ], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "exclude": { "default": [], "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 2 } } }, "additionalProperties": false } }, "additionalProperties": false }, "date_posted": { "description": "Only jobs posted within the last N days", "type": "object", "properties": { "last_days": { "examples": [ 30 ], "type": "integer", "minimum": 1, "maximum": 3650, "example": 30 } }, "additionalProperties": false } }, "additionalProperties": false }, "max_results": { "default": 10, "examples": [ 10 ], "description": "Maximum number of results to return", "type": "number", "minimum": 1, "maximum": 50 }, "cursor": { "default": null, "description": "Cursor to paginate through the results", "anyOf": [ { "type": "string", "minLength": 3 }, { "type": "null" } ] } }, "required": [ "company_linkedin_url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Response for status 200", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "total_results": { "type": "number", "examples": [ 100 ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "date_posted": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ai_summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "location": { "type": "object", "properties": { "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false } }, "additionalProperties": false, "examples": [ { "date_posted": "2026-07-08 23:00:07+02", "title": "Growth Marketing Manager, SMB Ads", "url": "https://www.linkedin.com/jobs/view/growth-marketing-manager-smb-ads-at-openai-4437309737", "company_name": "OpenAI", "company_linkedin_url": "https://www.linkedin.com/company/openai", "ai_summary": "The Growth Marketing Manager will execute growth experiments across acquisition, activation, lifecycle, and early retention for small business advertisers. They will build campaigns, lifecycle journeys, and various tests to help advertisers achieve their first meaningful spend and retention over time.", "location": { "city": "San Francisco", "country_code": "US" } } ] } }, "results_length": { "type": "number", "examples": [ 3 ] }, "max_results": { "type": "number", "examples": [ 10 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fair_usage": { "type": "object", "description": "Record usage, rate limit, and tracing data for this request.", "properties": { "records_used": { "type": "number", "description": "Records this request consumed, after reconciliation against the results actually returned.", "examples": [ 3 ] }, "records_remaining": { "type": "number", "description": "Records left on the plan after this request.", "examples": [ 9913547 ] }, "next_reset_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "When the record balance resets.", "examples": [ "2026-09-29T10:25:23.155Z" ] }, "rate_limit": { "type": "object", "description": "Absent on endpoints that are not rate limited.", "properties": { "requests_per_second": { "type": "number", "description": "Requests this API key may send per second on this endpoint. Set by your plan.", "examples": [ 10 ] }, "remaining_this_second": { "type": "number", "description": "Requests left in the current one-second window.", "examples": [ 9 ] } }, "required": [ "requests_per_second", "remaining_this_second" ], "additionalProperties": false }, "request_id": { "type": "string", "description": "Quote this id when you contact support.", "examples": [ "019bae09-0055-7441-b2ea-16086e499219" ] } }, "required": [ "records_used", "records_remaining", "next_reset_at", "request_id" ], "additionalProperties": false } }, "additionalProperties": false, "example": { "total_results": 12, "results": [ { "date_posted": "2026-07-21 22:59:39+02", "title": "Software Engineer, Product Engineering (Internal Apps)", "url": "https://www.linkedin.com/jobs/view/software-engineer-product-engineering-internal-apps-at-openai-1234567890", "company_name": "OpenAI", "company_linkedin_url": "https://www.linkedin.com/company/openai", "ai_summary": "Own the full product lifecycle for internal applications, from initial discovery and design to implementation and production support.Build scalable internal tools, user experiences, and durable workflows to support Finance and Supply Chain operations.", "location": { "city": "San Francisco", "country_code": "US" } }, { "date_posted": "2026-07-15 23:00:12+02", "title": "Full Stack Software Engineer, Codex", "url": "https://www.linkedin.com/jobs/view/full-stack-software-engineer-codex-at-openai-1234567891", "company_name": "OpenAI", "company_linkedin_url": "https://www.linkedin.com/company/openai", "ai_summary": "You will build end-to-end product experiences that span frontend applications, backend services, and developer tooling. The role involves designing AI-powered workflows and improving systems and workflows based on user feedback.", "location": { "city": "Seattle", "country_code": "US" } } ], "results_length": 2, "max_results": 2, "cursor": "eyJzIjpbMTcwMDAwMDAwMDAwMDAwMSwxMjM0NTY3ODkxXSwibyI6Mn0.ZXhhbXBsZS1jdXJzb3Itc2lnbmF0dXJlLW5vdC1yZWFs", "fair_usage": { "records_used": 2, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. max_results: Must be at most 50 (got 100).", "errors": [ { "field": "max_results", "message": "Must be at most 50 (got 100)." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Service temporarily unavailable, please try again later" } } } } } }, "operationId": "postV2JobsCompany" } }, "/v2/enrichment/person": { "post": { "summary": "Person Enrichment", "description": "Retrieve a professional's full profile and entire career history from their LinkedIn profile URL.", "tags": [ "People Enrichment" ], "operationId": "postV2EnrichmentPerson", "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "person_linkedin_url": { "type": "string", "description": "LinkedIn profile URL of the person to enrich.", "example": "https://www.linkedin.com/in/antoine-blitz-5581b7373" } }, "required": [ "person_linkedin_url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "person": { "first_name": "Antoine", "last_name": "Blitz", "full_name": "Antoine Blitz", "nickname": null, "civility_title": null, "headline": "Founder Blitzapi | @Blitzapi", "about_me": "I build developer-first tools for scalable, intelligent B2B prospecting. I\\'m the…", "location": { "city": null, "state_code": "NY", "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/antoine-blitz-5581b7373", "connections_count": 500, "profile_picture_url": null, "experiences": [ { "company_name": "Blitzapi", "job_title": "Founder Blitzapi", "company_linkedin_url": "https://www.linkedin.com/company/blitz-api", "company_linkedin_id": "be578414-239f-522e-b2e1-9246e22a52d1", "company_domain": "blitz-api.ai", "job_description": "We help GTM teams win faster by making high-quality B2B data and intent signals instantly available — directly in your existing stack.", "job_start_date": "2025-05-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": null, "state_code": null, "country_code": null } }, { "company_name": "Blitz Agency", "job_title": "Growth Engineer", "company_linkedin_url": "https://www.linkedin.com/company/blitz-agency", "company_linkedin_id": "3f0d1a8c-9b52-4c7e-8a41-2d6f5b7c9e10", "company_domain": "blitz-agency.com", "job_description": null, "job_start_date": "2022-01-01", "job_end_date": "2025-04-30", "job_is_current": false, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": "Paris", "state_code": null, "country_code": "FR" } } ], "education": [ { "school_name": "Michigan State University", "degree": "Bachelor of Science, Industrial Engineering", "start_date": "1990-09-01", "end_date": "1994-06-01" } ], "skills": [], "certifications": [] }, "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body, 2 errors. person_linkedin_url: Required. body: Unknown field \"linkedin_url\". Did you mean \"person_linkedin_url\"?", "errors": [ { "field": "person_linkedin_url", "message": "Required." }, { "field": "body", "message": "Unknown field \"linkedin_url\". Did you mean \"person_linkedin_url\"?" } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/enrichment/email": { "post": { "summary": "Find Work Email", "description": "Retrieve a verified work email address from a LinkedIn profile URL.", "tags": [ "People Enrichment" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "person_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/in/antoine-blitz-5581b7373" } }, "required": [ "person_linkedin_url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "email": "antoine@blitz-agency.com", "mx": [ { "priority": 1, "host": "aspmx.l.google.com" } ], "all_emails": [ { "email": "antoine@blitz-agency.com", "job_order_in_profile": 1, "company_linkedin_url": "https://www.linkedin.com/company/blitz-api", "email_domain": "blitz-agency.com", "mx": [ { "priority": 1, "host": "aspmx.l.google.com" } ] } ], "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body, 2 errors. person_linkedin_url: Required. body: Unknown field \"linkedin_url\". Did you mean \"person_linkedin_url\"?", "errors": [ { "field": "person_linkedin_url", "message": "Required." }, { "field": "body", "message": "Unknown field \"linkedin_url\". Did you mean \"person_linkedin_url\"?" } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/enrichment/phone": { "post": { "summary": "Find Mobile & Direct Phone", "description": "Retrieve a direct mobile phone number from a LinkedIn profile URL.", "tags": [ "People Enrichment" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "person_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/in/antoine-blitz-5581b7373" } }, "required": [ "person_linkedin_url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "phone": "+1234567890", "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body, 2 errors. person_linkedin_url: Required. body: Unknown field \"linkedin_url\". Did you mean \"person_linkedin_url\"?", "errors": [ { "field": "person_linkedin_url", "message": "Required." }, { "field": "body", "message": "Unknown field \"linkedin_url\". Did you mean \"person_linkedin_url\"?" } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/enrichment/email-to-person": { "post": { "summary": "Reverse Email Lookup", "description": "Identify a professional and retrieve their full profile starting from a verified work email address.", "tags": [ "People Enrichment" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "example": "jane.doe@example.com" } }, "required": [ "email" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "person": { "first_name": "Jane", "last_name": "Doe", "full_name": "Jane Doe", "nickname": null, "civility_title": null, "headline": "Head of Sales Development at Example Corp", "about_me": "I lead a sales development team that builds outbound target lists for B2B software buyers.", "location": { "city": null, "state_code": "NY", "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/example-person", "connections_count": 500, "profile_picture_url": null, "experiences": [ { "company_name": "Example Corp", "job_title": "Head of Sales Development", "company_linkedin_url": "https://www.linkedin.com/company/example-corp", "company_linkedin_id": "3f6c1a52-8d4e-4b7a-9c21-5e0f7d2a6b13", "company_domain": "example.com", "job_description": "Leads a team of eight sales development reps. Builds outbound target lists, sets weekly meeting goals and coaches reps on first-call messaging.", "job_start_date": "2025-05-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": null, "state_code": null, "country_code": null } } ], "education": [], "skills": [], "certifications": [] }, "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. email: Required.", "errors": [ { "field": "email", "message": "Required." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/enrichment/phone-to-person": { "post": { "summary": "Reverse Phone Lookup", "description": "Identify a professional and retrieve their full profile from a verified phone number.", "tags": [ "People Enrichment" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "phone": { "type": "string", "example": "+14155550123" } }, "required": [ "phone" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "person": { "first_name": "Jane", "last_name": "Doe", "full_name": "Jane Doe", "nickname": null, "civility_title": null, "headline": "Head of Sales Development at Example Corp", "about_me": "I lead a sales development team that builds outbound target lists for B2B software buyers.", "location": { "city": null, "state_code": "NY", "country_code": "US", "continent": "North America", "postal_code": null, "street_address": null }, "linkedin_url": "https://www.linkedin.com/in/example-person", "connections_count": 500, "profile_picture_url": null, "experiences": [ { "company_name": "Example Corp", "job_title": "Head of Sales Development", "company_linkedin_url": "https://www.linkedin.com/company/example-corp", "company_linkedin_id": "3f6c1a52-8d4e-4b7a-9c21-5e0f7d2a6b13", "company_domain": "example.com", "job_description": "Leads a team of eight sales development reps. Builds outbound target lists, sets weekly meeting goals and coaches reps on first-call messaging.", "job_start_date": "2025-05-01", "job_end_date": null, "job_is_current": true, "job_contract_type": null, "job_work_arrangement": null, "job_location": { "city": null, "state_code": null, "country_code": null } } ], "education": [], "skills": [], "certifications": [] }, "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. phone: Expected a string, got a number.", "errors": [ { "field": "phone", "message": "Expected a string, got a number." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/enrichment/company": { "post": { "tags": [ "Company Enrichment" ], "security": [ { "APIKey": [] } ], "summary": "Company Enrichment", "description": "Retrieve a full company profile from a LinkedIn company URL.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/blitz-api" } }, "required": [ "company_linkedin_url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "company": { "linkedin_url": "https://www.linkedin.com/company/blitz-api", "linkedin_id": 108037802, "name": "Blitzapi", "about": "BlitzAPI provides enriched B2B data access through a suite of flexible and high-performance APIs. 10+ public endpoints, covering- People & Company Search - Email & Phone Validation - Contact & Company Enrichment - LinkedIn Matching - Smart Waterfall ICP API-first + LLM-friendly + Low-code compatible Used by Growth & Revenue Teams", "specialties": null, "industry": "Technology; Information and Internet", "type": "Privately Held", "size": "1-10", "employees_on_linkedin": 3, "followers": 6, "founded_year": null, "hq": { "city": "Paris", "state": null, "country_code": "FR", "country_name": "France", "region": null, "continent": null }, "domain": "blitz-api.ai", "website": "https://blitz-api.ai", "mx": [ { "priority": 1, "host": "aspmx.l.google.com" } ] }, "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body, 2 errors. company_linkedin_url: Required. body: Unknown field \"company_url\". Allowed fields: company_linkedin_url.", "errors": [ { "field": "company_linkedin_url", "message": "Required." }, { "field": "body", "message": "Unknown field \"company_url\". Allowed fields: company_linkedin_url." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/enrichment/domain-to-linkedin": { "post": { "tags": [ "Company Enrichment" ], "security": [ { "APIKey": [] } ], "summary": "Domain to LinkedIn URL", "description": "Convert a website domain into a Company LinkedIn URL.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "example": "https://www.blitz-agency.com" } }, "required": [ "domain" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "company_linkedin_url": "https://www.linkedin.com/company/blitz-api", "company_name": "Blitz API", "other": [ { "company_linkedin_url": "https://www.linkedin.com/company/other-company", "company_name": "Other Company" } ], "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body, 2 errors. domain: Required. body: Unknown field \"website\". Allowed fields: domain.", "errors": [ { "field": "domain", "message": "Required." }, { "field": "body", "message": "Unknown field \"website\". Allowed fields: domain." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/enrichment/linkedin-to-domain": { "post": { "summary": "LinkedIn URL to Domain", "description": "Get the email domain associated with a Company LinkedIn URL.", "tags": [ "Company Enrichment" ], "security": [ { "APIKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/blitz-api" } }, "required": [ "company_linkedin_url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "email_domain": "blitz-agency.com", "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Not Found" } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. company_linkedin_url: Required.", "errors": [ { "field": "company_linkedin_url", "message": "Required." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/utils/current-date": { "post": { "tags": [ "Utilities" ], "security": [ { "APIKey": [] } ], "summary": "Get Current Date and Time", "description": "Get the current server date and time.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "region": { "description": "The timezone to get the date and time for.", "type": "string", "example": "America/New_York", "default": "America/New_York" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "datetime": "2026-01-08 12:00:00 -05:00", "timestamp": 1736385600, "timezone": "America/New_York", "timezone_name": "(GMT-05:00) New York", "fair_usage": { "records_used": 0, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body. region: Invalid timezone. Check the documentation for valid timezones.", "errors": [ { "field": "region", "message": "Invalid timezone. Check the documentation for valid timezones." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/enrichment/company-distribution-by-country": { "post": { "tags": [ "Company Enrichment" ], "security": [ { "APIKey": [] } ], "summary": "Company Distribution by Country", "description": "Returns the distribution of a company's employees grouped by ISO 3166-1 alpha-2 country code. Counts people, not jobs: a person with several jobs at the company is counted once. When the company is unknown or has no current employees, `found` is `false` and the call costs 0 records.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/openai" }, "is_recent_hire": { "default": false, "examples": [ false ], "description": "Only count people whose current job at the company started in the last 90 days. A job with no start date is not counted.", "type": "boolean" } }, "required": [ "company_linkedin_url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "company_linkedin_url": "https://www.linkedin.com/company/openai", "total_employees": 1234, "distribution": [ { "country": "US", "count": 900, "percentage_ratio": 72.93 }, { "country": "GB", "count": 200, "percentage_ratio": 16.21 }, { "country": "FR", "count": 80, "percentage_ratio": 6.48 }, { "country": "unknown", "count": 54, "percentage_ratio": 4.38 } ], "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body, 2 errors. company_linkedin_url: Required. body: Unknown field \"company_url\". Allowed fields: company_linkedin_url.", "errors": [ { "field": "company_linkedin_url", "message": "Required." }, { "field": "body", "message": "Unknown field \"company_url\". Allowed fields: company_linkedin_url." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/v2/enrichment/company-distribution-by-department": { "post": { "tags": [ "Company Enrichment" ], "security": [ { "APIKey": [] } ], "summary": "Company Distribution by Department", "description": "Returns the distribution of a company's employees grouped by department. Employees with no classified department are counted under \"Other\". When the company is unknown or has no current employees, `found` is `false` and the call costs 0 records.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company_linkedin_url": { "type": "string", "example": "https://www.linkedin.com/company/openai" }, "is_recent_hire": { "default": false, "examples": [ false ], "description": "Only count people whose current job at the company started in the last 90 days. A job with no start date is not counted.", "type": "boolean" } }, "required": [ "company_linkedin_url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "example": { "found": true, "company_linkedin_url": "https://www.linkedin.com/company/openai", "total_employees": 1234, "distribution": [ { "department": "Engineering", "count": 420, "percentage_ratio": 34.04 }, { "department": "Sales", "count": 260, "percentage_ratio": 21.07 }, { "department": "Operations", "count": 180, "percentage_ratio": 14.59 }, { "department": "Marketing", "count": 140, "percentage_ratio": 11.35 }, { "department": "Finance", "count": 90, "percentage_ratio": 7.29 }, { "department": "Human Resources", "count": 80, "percentage_ratio": 6.48 }, { "department": "Other", "count": 64, "percentage_ratio": 5.19 } ], "fair_usage": { "records_used": 1, "records_remaining": 9913547, "next_reset_at": "2026-09-29T10:25:23.155Z", "rate_limit": { "requests_per_second": 10, "remaining_this_second": 9 }, "request_id": "019bae09-0055-7441-b2ea-16086e499219" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "The request body is not valid JSON. Send a JSON object with the header Content-Type: application/json." } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Invalid API key, please provide a valid API key in the 'x-api-key' header" } } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Fair Use limit reached. Upgrade your plan at app.blitz-api.ai/billing or contact support to increase your monthly capacity." } } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationError" }, "example": { "success": false, "message": "Invalid request body, 2 errors. company_linkedin_url: Required. body: Unknown field \"company_url\". Allowed fields: company_linkedin_url.", "errors": [ { "field": "company_linkedin_url", "message": "Required." }, { "field": "body", "message": "Unknown field \"company_url\". Allowed fields: company_linkedin_url." } ] } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "example": { "success": false, "message": "Rate limit exceeded, please try again later" } } } } } } } }, "/changelog": { "get": { "summary": "Get the BlitzAPI changelog", "description": "Public endpoint: no API key required. Returns changelog entries newest-first: breaking changes, new features, improvements, fixes, deprecations, and announcements. Use `days` to limit to recent changes and `limit` to cap the number of entries (default 50).", "tags": [ "Changelog" ], "operationId": "getChangelog", "security": [], "parameters": [ { "in": "query", "name": "days", "required": false, "description": "Only return entries from the last N days. Omit for the full history.", "schema": { "type": "integer", "exclusiveMinimum": 0, "example": 7 } }, { "in": "query", "name": "limit", "required": false, "description": "Maximum number of entries to return. Defaults to 50.", "schema": { "type": "integer", "default": 50, "exclusiveMinimum": 0, "example": 50 } } ], "responses": { "200": { "description": "Changelog entries, newest-first.", "content": { "application/json": { "schema": { "type": "array", "description": "Changelog entries, newest-first.", "items": { "type": "object", "description": "A single changelog entry.", "required": [ "date", "type", "title" ], "properties": { "date": { "type": "string", "description": "Publish date in UTC (YYYY-MM-DD)." }, "type": { "type": "string", "enum": [ "breaking", "feature", "improvement", "fix", "deprecation", "announcement" ], "description": "Impact category of the change." }, "title": { "type": "string", "description": "Short headline for the change." }, "body": { "type": "string", "description": "Optional Markdown detail." }, "affected_endpoints": { "type": "array", "description": "API routes affected by this change. Omitted or empty for product announcements.", "items": { "type": "string" } }, "links": { "type": "array", "description": "External links related to the entry (docs, migration guide, blog post).", "items": { "type": "object", "required": [ "label", "url" ], "properties": { "label": { "type": "string" }, "url": { "type": "string" } } } } } }, "example": [ { "date": "2026-08-04", "type": "breaking", "title": "People search now accepts `industry` as an array", "body": "The `industry` filter now accepts a list of values. Passing a single string still works.\n\nSee the migration guide.", "affected_endpoints": [ "/v2/search/people" ], "links": [ { "label": "Migration guide", "url": "https://docs.blitz-api.ai/changelog" } ] } ] } } } } } } } }, "components": { "securitySchemes": { "APIKey": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Your BlitzAPI key. Get one from https://app.blitz-api.ai" } }, "schemas": { "ValidationError": { "type": "object", "description": "The request body has an unknown field or an invalid value. The request did not run and used no records.", "required": [ "success", "message", "errors" ], "properties": { "success": { "type": "boolean", "description": "Always `false`." }, "message": { "type": "string", "description": "One-line summary of the first three errors, for logs. The wording can change, so read `errors` to find what to fix." }, "errors": { "type": "array", "maxItems": 20, "description": "One item per problem, up to 20.", "items": { "type": "object", "required": [ "field", "message" ], "properties": { "field": { "type": "string", "description": "Path to the problem. Dots mark nesting and `[n]` marks an array item, e.g. `company.industry.include[0]`. For an unknown field, this is the object that contains it (`body` for a top-level field)." }, "message": { "type": "string", "description": "What is wrong. When the input is close to a valid field or value, it suggests the closest match. Otherwise a short list of allowed fields or values is given in full." } } } } } } } } }