---
type: "firecrawl-provider"
description: "Search and enrich companies and people, find work emails, and search job postings."
use_when: "Find people at companies, list one company's employees, or enrich a profile, work email, or phone.\n\nSearch companies, build a list from hiring or headcount, and enrich a company from a LinkedIn URL or a domain.\n\nSearch live job postings across companies, or list the jobs at one company."
categories: "Jobs"
capabilities: 17
pricing: "10 credits per billed unit; see each capability for its unit and maximum."
---
# BlitzAPI on Firecrawl Alexandria

Search and enrich companies and people, find work emails, and search job postings.

- Categories: Jobs
- Category index: [Jobs category](https://alexandria.firecrawl.dev/agents/categories/jobs)
- Provider key: `blitzapi`
- Access: Firecrawl credits
- Cost (Find people): 10 credits per record
- Cost (Employee finder): 10 credits per record
- Cost (Waterfall ICP search): 10 credits per record
- Cost (Person enrichment): 10 credits per record
- Cost (Work email): 10 credits per record
- Cost (Reverse email lookup): 10 credits per record
- Cost (Reverse phone lookup): 10 credits per record
- Cost (Company search): 10 credits per record
- Cost (Companies hiring): 10 credits per record
- Cost (Companies by persona): 10 credits per record
- Cost (Company enrichment): 10 credits per record
- Cost (Domain to LinkedIn): 10 credits per record
- Cost (LinkedIn to domain): 10 credits per record
- Cost (Employees by country): 10 credits per record
- Cost (Employees by department): 10 credits per record
- Cost (Job search): 10 credits per record
- Cost (Company jobs): 10 credits per record

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/blitzapi)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/blitzapi/openapi.json)

## Capabilities

- [Find people](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/search): A page of people under results. Each item is the person and the job that matched. total_results is the match count, and cursor continues the search. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- [Employee finder](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/employees): A page of people under results. page and total_pages describe the list. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- [Waterfall ICP search](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/waterfall): People under results. icp is the 1-based tier that matched, and ranking is the order across tiers. The person sits on person. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- [Person enrichment](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/enrich): found is false on a miss, and that call costs nothing. person is the profile when found is true. fair_usage.records_used is 1 on a billed hit and 0 on a miss.
- [Work email](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/email): found is false and email is absent on a miss. A hit includes email, the domain's mx records, and all_emails. fair_usage.records_used is the charge.
- [Reverse email lookup](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/email-reverse): found is false on a miss. person is the profile when found is true. fair_usage.records_used is the charge.
- [Reverse phone lookup](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/phone-reverse): found is false on a miss. person is the profile when found is true. fair_usage.records_used is the charge.
- [Company search](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/search): Companies under results. total_results is the match count, and cursor continues the search. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- [Companies hiring](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/tam-by-jobs): Companies under results. matched_jobs is how many postings matched. cursor continues the list. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- [Companies by persona](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/tam-by-people): Companies under results. matched_people is how many current employees matched. cursor continues the list. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/enrich): found is false on a miss. company is the profile when found is true, including mx. fair_usage.records_used is the charge.
- [Domain to LinkedIn](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/domain-to-linkedin): found is false on a miss. A hit includes company_linkedin_url and company_name. other lists additional matches when BlitzAPI has them. fair_usage.records_used is the charge.
- [LinkedIn to domain](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/linkedin-to-domain): found is false on a miss. email_domain is the work-email domain on a hit. fair_usage.records_used is the charge.
- [Employees by country](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/employees-by-country): found is false when the company is unknown or has no current employees, and that call costs nothing. distribution is one row per country: country, count, and percentage_ratio. The charge is one record, not one per country.
- [Employees by department](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/employees-by-department): found is false when the company is unknown or has no current employees. distribution is one row per department: department, count, and percentage_ratio. The charge is one record.
- [Job search](https://alexandria.firecrawl.dev/agents/providers/blitzapi/jobs/search): Postings under results. total_results is the match count, and cursor continues the search. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- [Company jobs](https://alexandria.firecrawl.dev/agents/providers/blitzapi/jobs/company): Postings under results, scoped to company_linkedin_url. cursor continues the list. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.

## 1. Choose this provider when

Find people at companies, list one company's employees, or enrich a profile, work email, or phone.

Search companies, build a list from hiring or headcount, and enrich a company from a LinkedIn URL or a domain.

Search live job postings across companies, or list the jobs at one company.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "blitzapi",
  "capability": "people/search",
  "options": {
    "max_results": 10
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `company` (object): Company filters: name, industry, type, employee_range, employee_count, hq, keywords, revenue, funding, and the other fields BlitzAPI documents on this route. Example: `{}`
- `people` (object): Person filters: job_title, job_level, job_function, location, education, and the other fields BlitzAPI documents on this route. Example: `{}`
- `max_results` (number): Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 50. Example: `10`
- `cursor` (string): Cursor from the previous page. Omit it for the first page. Example: `<cursor>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "blitzapi",
    capability: "people/search",
    options: {
      max_results: 10,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "blitzapi",
  "capability": "people/search",
  "options": {
    "max_results": 10
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "blitzapi",
    "capability": "people/search",
    "options": {
      "max_results": 10
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'blitzapi/people/search' \
  --options '{"max_results":10}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "blitzapi",
  "capability": "people/search",
  "options": {
    "max_results": 10
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "blitzapi",
  "capability": "people/search",
  "options": {
    "max_results": 10
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "results": [
    {
      "full_name": "<full_name>",
      "first_name": "<first_name>",
      "last_name": "<last_name>",
      "headline": "<headline>",
      "linkedin_url": "<linkedin_url>",
      "location": {},
      "connections_count": 0,
      "experiences": []
    }
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Find people

- Capability: `people/search`
- Description: A page of people under results. Each item is the person and the job that matched. total_results is the match count, and cursor continues the search. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- Instructions: Search people across companies by title, level, location, and company filters. 10 credits per returned person. An empty page costs nothing. max_results is capped at 10. Use people/employees to list one company, and people/enrich for a full career history.
- Cost: 10 credits per record
- Capability file: [Find people](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/search)

Accepted options:
- `company` (object): Company filters: name, industry, type, employee_range, employee_count, hq, keywords, revenue, funding, and the other fields BlitzAPI documents on this route. Example: `{}`
- `people` (object): Person filters: job_title, job_level, job_function, location, education, and the other fields BlitzAPI documents on this route. Example: `{}`
- `max_results` (number): Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 50. Example: `10`
- `cursor` (string): Cursor from the previous page. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "results": [
    {
      "full_name": "<full_name>",
      "first_name": "<first_name>",
      "last_name": "<last_name>",
      "headline": "<headline>",
      "linkedin_url": "<linkedin_url>",
      "location": {},
      "connections_count": 0,
      "experiences": []
    }
  ]
}
```

### Employee finder

- Capability: `people/employees`
- Description: A page of people under results. page and total_pages describe the list. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- Instructions: List the employees of one company by level, function, and location. 10 credits per returned person. An empty page costs nothing. max_results is capped at 10; use page for the next slice. Use people/search to look across many companies.
- Cost: 10 credits per record
- Capability file: [Employee finder](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/employees)

Accepted options:
- `company_linkedin_url` (string, required): LinkedIn company URL, in a format BlitzAPI accepts. Example: `<company_linkedin_url>`
- `country_code` (string[]): Country codes of the people to keep. Omit for the upstream default, which is the whole world. Example: `[]`
- `continent` (string[]): Continents where the people live. Example: `[]`
- `sales_region` (string[]): Sales regions: NORAM, LATAM, EMEA, or APAC. Example: `[]`
- `job_level` (string[]): Job levels, using BlitzAPI's accepted values. Example: `[]`
- `job_function` (string[]): Job functions, using BlitzAPI's accepted values. Example: `[]`
- `min_connections_count` (number): Minimum LinkedIn connections, from 0 to 500. Example: `10`
- `is_recent_hire` (boolean): When true, only people whose current job at the company started in the last 90 days. A job with no start date does not match. Example: `false`
- `max_results` (number): Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 50. Example: `10`
- `page` (number): 1-based page. Each page returns at most max_results people. Example: `10`

Response schema example:
```json
{
  "results": [
    {
      "full_name": "<full_name>",
      "first_name": "<first_name>",
      "last_name": "<last_name>",
      "headline": "<headline>",
      "linkedin_url": "<linkedin_url>",
      "location": {},
      "connections_count": 0,
      "experiences": []
    }
  ]
}
```

### Waterfall ICP search

- Capability: `people/waterfall`
- Description: People under results. icp is the 1-based tier that matched, and ranking is the order across tiers. The person sits on person. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- Instructions: Find the best-matching people at one company from an ordered list of titles. 10 credits per returned person. An empty page costs nothing. max_results is capped at 10, and this route has no cursor. Use people/employees to page through a whole team.
- Cost: 10 credits per record
- Capability file: [Waterfall ICP search](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/waterfall)

Accepted options:
- `company_linkedin_url` (string, required): LinkedIn company URL, in a format BlitzAPI accepts. Example: `<company_linkedin_url>`
- `cascade` (object[], required): 1 to 10 tiers, in priority order. Each tier needs include_title, 1 to 50 phrases. Later tiers fill slots the earlier tiers left open. Example: `[]`
- `max_results` (number): Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 100. Example: `10`
- `profile_min_connections` (number): Minimum LinkedIn connections a profile must have. 0 includes everyone. Example: `10`

Response schema example:
```json
{
  "results": [
    {
      "icp": 0,
      "ranking": 0,
      "person": {}
    }
  ]
}
```

### Person enrichment

- Capability: `people/enrich`
- Description: found is false on a miss, and that call costs nothing. person is the profile when found is true. fair_usage.records_used is 1 on a billed hit and 0 on a miss.
- Instructions: Enrich one person from a LinkedIn profile URL: headline, location, and the full career. 10 credits when BlitzAPI bills the record. A miss costs nothing. Use people/email for the work email and people/phone for a US number.
- Cost: 10 credits per record
- Capability file: [Person enrichment](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/enrich)

Accepted options:
- `person_linkedin_url` (string, required): LinkedIn profile URL, in a format BlitzAPI accepts. Example: `<person_linkedin_url>`

Response schema example:
```json
{
  "found": false,
  "person": {}
}
```

### Work email

- Capability: `people/email`
- Description: found is false and email is absent on a miss. A hit includes email, the domain's mx records, and all_emails. fair_usage.records_used is the charge.
- Instructions: Look up a verified work email from a LinkedIn profile URL. 10 credits when BlitzAPI bills the record. A miss costs nothing. Use people/email-reverse when you already have the address.
- Cost: 10 credits per record
- Capability file: [Work email](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/email)

Accepted options:
- `person_linkedin_url` (string, required): LinkedIn profile URL, in a format BlitzAPI accepts. Example: `<person_linkedin_url>`

Response schema example:
```json
{
  "found": false,
  "email": "<email>",
  "mx": [],
  "all_emails": []
}
```

### Reverse email lookup

- Capability: `people/email-reverse`
- Description: found is false on a miss. person is the profile when found is true. fair_usage.records_used is the charge.
- Instructions: Identify the person behind a work email: name, LinkedIn URL, and current job. 10 credits when BlitzAPI bills the record. A miss costs nothing. Use people/email when you have the profile URL and need the address.
- Cost: 10 credits per record
- Capability file: [Reverse email lookup](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/email-reverse)

Accepted options:
- `email` (string, required): Work email to look up. Example: `<email>`

Response schema example:
```json
{
  "found": false,
  "person": {}
}
```

### Reverse phone lookup

- Capability: `people/phone-reverse`
- Description: found is false on a miss. person is the profile when found is true. fair_usage.records_used is the charge.
- Instructions: Identify the person behind a US phone number. 10 credits when BlitzAPI bills the record. A miss costs nothing. Use people/phone when you have the profile URL and need the number.
- Cost: 10 credits per record
- Capability file: [Reverse phone lookup](https://alexandria.firecrawl.dev/agents/providers/blitzapi/people/phone-reverse)

Accepted options:
- `phone` (string, required): Phone number. Include the country code, such as +14155550123. A number without one is read as a US number. Example: `<phone>`

Response schema example:
```json
{
  "found": false,
  "person": {}
}
```

### Company search

- Capability: `companies/search`
- Description: Companies under results. total_results is the match count, and cursor continues the search. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- Instructions: Search companies by industry, headcount, location, funding, and keywords. 10 credits per returned company. An empty page costs nothing. max_results is capped at 10. Use companies/enrich to read one company in full.
- Cost: 10 credits per record
- Capability file: [Company search](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/search)

Accepted options:
- `company` (object): Company filters: name, industry, type, employee_range, employee_count, hq, keywords, revenue, funding, and the other fields BlitzAPI documents on this route. Example: `{}`
- `max_results` (number): Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 50. Example: `10`
- `cursor` (string): Cursor from the previous page. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "results": [
    {
      "name": "<name>",
      "domain": "<domain>",
      "website": "<website>",
      "linkedin_url": "<linkedin_url>",
      "industry": "<industry>",
      "type": "<type>",
      "size": "<size>",
      "employees_on_linkedin": 0,
      "hq": {}
    }
  ]
}
```

### Companies hiring

- Capability: `companies/tam-by-jobs`
- Description: Companies under results. matched_jobs is how many postings matched. cursor continues the list. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- Instructions: Find distinct companies hiring for a role. 10 credits per returned company, not per job. An empty page costs nothing. max_results is capped at 10. Use jobs/search when you need the postings themselves.
- Cost: 10 credits per record
- Capability file: [Companies hiring](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/tam-by-jobs)

Accepted options:
- `job` (object): Job filters: title, description, seniority, location, and date_posted.last_days. Field names are BlitzAPI's. Example: `{}`
- `company` (object): Firmographic filters for the hiring company: industry, employee_count, size, keywords, hq, and mx. Example: `{}`
- `max_results` (number): Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 50. Example: `10`
- `cursor` (string): Cursor from the previous page. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "results": [
    {
      "company": {},
      "matched_jobs": 0
    }
  ]
}
```

### Companies by persona

- Capability: `companies/tam-by-people`
- Description: Companies under results. matched_people is how many current employees matched. cursor continues the list. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- Instructions: Find distinct companies whose current employees match a persona. 10 credits per returned company. An empty page costs nothing. max_results is capped at 10. Use people/search when you need the people.
- Cost: 10 credits per record
- Capability file: [Companies by persona](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/tam-by-people)

Accepted options:
- `company` (object): Company filters: name, industry, type, employee_range, employee_count, hq, keywords, revenue, funding, and the other fields BlitzAPI documents on this route. Example: `{}`
- `people` (object): Person filters: job_title, job_level, job_function, location, education, and the other fields BlitzAPI documents on this route. Example: `{}`
- `max_results` (number): Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 50. Example: `10`
- `cursor` (string): Cursor from the previous page. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "results": [
    {
      "company": {},
      "matched_people": 0
    }
  ]
}
```

### Company enrichment

- Capability: `companies/enrich`
- Description: found is false on a miss. company is the profile when found is true, including mx. fair_usage.records_used is the charge.
- Instructions: Enrich one company from its LinkedIn company URL: name, industry, size, headquarters, domain, and MX records. 10 credits when BlitzAPI bills the record. A miss costs nothing. Use companies/domain-to-linkedin when you only have a domain.
- Cost: 10 credits per record
- Capability file: [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/enrich)

Accepted options:
- `company_linkedin_url` (string, required): LinkedIn company URL, in a format BlitzAPI accepts. Example: `<company_linkedin_url>`

Response schema example:
```json
{
  "found": false,
  "company": {}
}
```

### Domain to LinkedIn

- Capability: `companies/domain-to-linkedin`
- Description: found is false on a miss. A hit includes company_linkedin_url and company_name. other lists additional matches when BlitzAPI has them. fair_usage.records_used is the charge.
- Instructions: Resolve a website domain to a LinkedIn company URL and name. 10 credits when BlitzAPI bills the record. A miss costs nothing. Use companies/enrich on the URL this returns.
- Cost: 10 credits per record
- Capability file: [Domain to LinkedIn](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/domain-to-linkedin)

Accepted options:
- `domain` (string, required): Website domain, such as stripe.com, without a scheme or path. Example: `<domain>`

Response schema example:
```json
{
  "found": false,
  "company_linkedin_url": "<company_linkedin_url>",
  "company_name": "<company_name>",
  "other": []
}
```

### LinkedIn to domain

- Capability: `companies/linkedin-to-domain`
- Description: found is false on a miss. email_domain is the work-email domain on a hit. fair_usage.records_used is the charge.
- Instructions: Find the email domain a company uses for work addresses, from its LinkedIn company URL. It can differ from the public website. 10 credits when BlitzAPI bills the record. A miss costs nothing.
- Cost: 10 credits per record
- Capability file: [LinkedIn to domain](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/linkedin-to-domain)

Accepted options:
- `company_linkedin_url` (string, required): LinkedIn company URL, in a format BlitzAPI accepts. Example: `<company_linkedin_url>`

Response schema example:
```json
{
  "found": false,
  "email_domain": "<email_domain>"
}
```

### Employees by country

- Capability: `companies/employees-by-country`
- Description: found is false when the company is unknown or has no current employees, and that call costs nothing. distribution is one row per country: country, count, and percentage_ratio. The charge is one record, not one per country.
- Instructions: Break a company's employees down by country. 10 credits when BlitzAPI bills the company, including when several countries come back. A miss, or a company with no current employees, costs nothing.
- Cost: 10 credits per record
- Capability file: [Employees by country](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/employees-by-country)

Accepted options:
- `company_linkedin_url` (string, required): LinkedIn company URL, in a format BlitzAPI accepts. Example: `<company_linkedin_url>`
- `is_recent_hire` (boolean): When true, only people whose current job at the company started in the last 90 days. A job with no start date does not match. Example: `false`

Response schema example:
```json
{
  "found": false,
  "company_linkedin_url": "<company_linkedin_url>",
  "total_employees": 0,
  "distribution": []
}
```

### Employees by department

- Capability: `companies/employees-by-department`
- Description: found is false when the company is unknown or has no current employees. distribution is one row per department: department, count, and percentage_ratio. The charge is one record.
- Instructions: Break a company's current jobs down by department. 10 credits when BlitzAPI bills the company. A miss costs nothing. Counts jobs, so a person with two current jobs counts twice.
- Cost: 10 credits per record
- Capability file: [Employees by department](https://alexandria.firecrawl.dev/agents/providers/blitzapi/companies/employees-by-department)

Accepted options:
- `company_linkedin_url` (string, required): LinkedIn company URL, in a format BlitzAPI accepts. Example: `<company_linkedin_url>`
- `is_recent_hire` (boolean): When true, only people whose current job at the company started in the last 90 days. A job with no start date does not match. Example: `false`

Response schema example:
```json
{
  "found": false,
  "company_linkedin_url": "<company_linkedin_url>",
  "total_employees": 0,
  "distribution": []
}
```

### Job search

- Capability: `jobs/search`
- Description: Postings under results. total_results is the match count, and cursor continues the search. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- Instructions: Search live job postings by title, seniority, location, and company filters. 10 credits per returned posting. An empty page costs nothing. max_results is capped at 10. Use companies/tam-by-jobs for the distinct hiring companies.
- Cost: 10 credits per record
- Capability file: [Job search](https://alexandria.firecrawl.dev/agents/providers/blitzapi/jobs/search)

Accepted options:
- `job` (object): Job filters: title, description, seniority, location, and date_posted.last_days. Field names are BlitzAPI's. Example: `{}`
- `company` (object): Firmographic filters for the hiring company: industry, employee_count, size, keywords, hq, and mx. Example: `{}`
- `max_results` (number): Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 50. Example: `10`
- `cursor` (string): Cursor from the previous page. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "results": [
    {
      "title": "<title>",
      "url": "<url>",
      "date_posted": "<date_posted>",
      "company_name": "<company_name>",
      "company_linkedin_url": "<company_linkedin_url>",
      "ai_summary": "<ai_summary>",
      "location": {}
    }
  ]
}
```

### Company jobs

- Capability: `jobs/company`
- Description: Postings under results, scoped to company_linkedin_url. cursor continues the list. fair_usage.records_used is what this call consumed. records_remaining is the plan balance. An empty results array with records_used 0 costs nothing.
- Instructions: List live job postings at one company. 10 credits per returned posting. An empty page costs nothing. max_results is capped at 10. Use jobs/search to look across companies.
- Cost: 10 credits per record
- Capability file: [Company jobs](https://alexandria.firecrawl.dev/agents/providers/blitzapi/jobs/company)

Accepted options:
- `company_linkedin_url` (string, required): LinkedIn company URL, in a format BlitzAPI accepts. Example: `<company_linkedin_url>`
- `job` (object): Job filters: title, description, seniority, location, and date_posted.last_days. Field names are BlitzAPI's. Example: `{}`
- `max_results` (number): Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 50. Example: `10`
- `cursor` (string): Cursor from the previous page. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "results": [
    {
      "title": "<title>",
      "url": "<url>",
      "date_posted": "<date_posted>",
      "company_name": "<company_name>",
      "company_linkedin_url": "<company_linkedin_url>",
      "ai_summary": "<ai_summary>",
      "location": {}
    }
  ]
}
```
