> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blitz-api.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Search Company Jobs
> List job postings at a single company from its LinkedIn company URL, with optional job-level filters.
> **Agents & LLMs**: a Markdown version of this page is available by appending `.md` to the URL, and the full documentation index is at [llms.txt](https://docs.blitz-api.ai/llms.txt).
**Cost:** 1 credit per job returned on Trial Plan
**Free** on the Unlimited plan
List live job postings at a single company. Pass the target's `company_linkedin_url` to scope results to that company, then optionally narrow with job-level filters (title, description, field, seniority, employment type, work arrangement, location, date posted).
**Pagination is cursor-based.** Pass the `cursor` returned by each response back into the next request. `cursor: null` means you're on the first page; a `null` cursor in the response means you've reached the end. A single query returns up to **5,000 jobs**, paginating through a maximum of **50 results** per request.
**Filter logic:** all filters combine with **AND**. Multiple values within a single `include` list combine with **OR**. Use `exclude` to filter matches out.
## OpenAPI
````yaml api-reference/v2.openapi.json POST /v2/jobs/company
openapi: 3.1.0
info:
title: Blitz API Reference
version: 2.0.0
description: >-
Welcome to the Blitz API Reference.
Use this interactive documentation to explore and test every v2 endpoint.
Authentication is required via the `x-api-key` header.
**Base URL**: `https://api.blitz-api.ai`
**Rate limit**: 5 requests per second, per endpoint (all plans). Each
endpoint has its own independent budget, so different endpoints don't share
the limit.
**Pricing**: All endpoints are unlimited on paid plans ($399+/mo). Free
trial accounts receive 1,000 credits.
servers:
- url: https://api.blitz-api.ai
description: Production server
security: []
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).
paths:
/v2/jobs/company:
post:
tags:
- Job Search
summary: Search Company Jobs
description: >-
List job postings at a single company from its LinkedIn company URL,
with optional job-level filters.
operationId: postV2JobsCompany
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)
type: object
properties:
include:
default: []
type: array
items:
type: string
examples:
- - Software Engineer
example:
- Software Engineer
exclude:
default: []
type: array
items:
type: string
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
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
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
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+
examples:
- - 2-5
- 5-10
example:
- 2-5
- 5-10
exclude:
default: []
type: array
items:
type: string
enum:
- 0-2
- 2-5
- 5-10
- 10+
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
examples:
- - FULL_TIME
example:
- FULL_TIME
exclude:
default: []
type: array
items:
type: string
enum:
- FULL_TIME
- PART_TIME
- CONTRACTOR
- TEMPORARY
- INTERN
- VOLUNTEER
- PER_DIEM
- OTHER
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
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
country_code:
description: >-
Exact matches (ISO-3166 alpha-2) on the job location
country
type: object
properties:
include:
default: []
type: array
items:
type: string
minLength: 2
maxLength: 2
exclude:
default: []
type: array
items:
type: string
minLength: 2
maxLength: 2
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
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
- type: 'null'
examples:
- null
example: null
required:
- company_linkedin_url
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
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
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
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
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+
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
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
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
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
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
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
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
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
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
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
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+
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
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
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
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
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
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
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'
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
'401':
description: Response for status 401
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
success:
type: boolean
const: false
message:
type: string
additionalProperties: false
examples:
- success: false
message: >-
Invalid API key, please provide a valid API key in the
'x-api-key' header
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:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
success:
type: boolean
const: false
message:
type: string
additionalProperties: false
example:
success: false
message: Insufficient credits
'429':
description: Response for status 429
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
success:
type: boolean
const: false
message:
type: string
additionalProperties: false
examples:
- success: false
message: Rate limit exceeded, please try again later
example:
success: false
message: Rate limit exceeded, please try again later
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
example: 1
RateLimit-Limit:
description: Requests allowed in the current window.
schema:
type: integer
example: 100
RateLimit-Remaining:
description: Requests left in the current window.
schema:
type: integer
example: 0
RateLimit-Reset:
description: Seconds until the window resets.
schema:
type: integer
example: 1
RateLimit-Policy:
description: Window policy, `;w=`.
schema:
type: string
example: 100;w=1
security:
- APIKey: []
components:
securitySchemes:
APIKey:
type: apiKey
in: header
name: x-api-key
description: Your Blitz API Key. Get one from https://app.blitz-api.ai
````