--- type: "firecrawl-provider" description: "Company firmographics, lookalikes, hiring, technology detections, and classified news events." use_when: "Company firmographics, lookalikes, job openings, technology detections, and classified news events." categories: "Company" capabilities: 6 credits_range: 10 --- # PredictLeads on Firecrawl Alexandria Company firmographics, lookalikes, hiring, technology detections, and classified news events. - Categories: Company - Category index: [Company category](https://alexandria.firecrawl.dev/agents/categories/company) - Provider key: `predictleads` - Access: Firecrawl credits - Cost (Company enrichment): 10 credits per call - Cost (Company discovery): 10 credits per record - Cost (Similar companies): 10 credits per record - Cost (Job openings): 10 credits per call - Cost (Technology detections): 10 credits per call - Cost (News events): 10 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/predictleads) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/predictleads/openapi.json) ## Capabilities - [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/enrich): Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - [Company discovery](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/discover): Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - [Similar companies](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/similar): Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - [Job openings](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/job-openings): Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - [Technology detections](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/technology-detections): Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - [News events](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/news-events): Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. ## 1. Choose this provider when Company firmographics, lookalikes, job openings, technology detections, and classified news events. ## 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": "predictleads", "capability": "companies/enrich", "options": { "id_or_domain": "" } } ``` ## 3. Add provider options Use only the options needed for the task: - `id_or_domain` (string, required): Company domain without a scheme, such as stripe.com, or a PredictLeads company id. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "predictleads", capability: "companies/enrich", options: { id_or_domain: "", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "predictleads", "capability": "companies/enrich", "options": { "id_or_domain": "" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "predictleads", "capability": "companies/enrich", "options": { "id_or_domain": "" } } }' ``` ### CLI ```sh firecrawl scrape 'predictleads/companies/enrich' \ --options '{"id_or_domain":""}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "predictleads", "capability": "companies/enrich", "options": { "id_or_domain": "" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "predictleads", "capability": "companies/enrich", "options": { "id_or_domain": "" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "data": [ { "id": "", "type": "", "attributes": {}, "relationships": {} } ] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Company enrichment - Capability: `companies/enrich` - Description: Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - Instructions: Enrich one company from its domain or PredictLeads id. The response data array holds the company. 10 credits per response, including an empty array. A 404 costs nothing. - Cost: 10 credits per call - Capability file: [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/enrich) Accepted options: - `id_or_domain` (string, required): Company domain without a scheme, such as stripe.com, or a PredictLeads company id. Example: `` Response schema example: ```json { "data": [ { "id": "", "type": "", "attributes": {}, "relationships": {} } ] } ``` ### Company discovery - Capability: `companies/discover` - Description: Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - Instructions: Find companies by location, size, industry, or revenue. Each returned company costs 10 credits, and an empty page costs nothing. Ask for a small limit first. Use companies/enrich when you already have a domain. - Cost: 10 credits per record - Capability file: [Company discovery](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/discover) Accepted options: - `location` (string): Country name, or a US state name or abbreviation. Example: `` - `sizes` (string): Comma-separated headcount buckets, such as 11-50. Example: `` - `naics_codes` (string): Comma-separated NAICS codes. Example: `` - `industry` (string): Free-text industry, such as Retail. Example: `` - `revenue_range_low` (number): Minimum annual revenue in USD. Example: `10` - `revenue_range_high` (number): Maximum annual revenue in USD. Example: `10` - `page` (number): 1-based page. Omitting it can drop the result count. Example: `10` - `limit` (number): Companies to return, from 1 to 10. Each returned company costs 10 credits. Omitted calls request 1. Example: `1` Response schema example: ```json { "data": [ { "id": "", "type": "", "attributes": {}, "relationships": {} } ] } ``` ### Similar companies - Capability: `companies/similar` - Description: Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - Instructions: List companies similar to a domain, with a score and, for the closest matches, a reason. Each returned company costs 10 credits. An empty page costs nothing. - Cost: 10 credits per record - Capability file: [Similar companies](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/similar) Accepted options: - `company_id_or_domain` (string, required): Company domain without a scheme, such as stripe.com, or a PredictLeads company id. Example: `` - `page` (number): 1-based page. Example: `10` - `limit` (number): Lookalikes to return, from 1 to 10. Each returned company costs 10 credits. Omitted calls request 1. Example: `1` Response schema example: ```json { "data": [ { "id": "", "type": "", "attributes": {}, "relationships": {} } ] } ``` ### Job openings - Capability: `companies/job-openings` - Description: Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - Instructions: List job openings scraped from a company's own careers site. One response costs 10 credits however many openings it contains, up to 1000. A 404 costs nothing. - Cost: 10 credits per call - Capability file: [Job openings](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/job-openings) Accepted options: - `company_id_or_domain` (string, required): Company domain without a scheme, such as stripe.com, or a PredictLeads company id. Example: `` - `active_only` (boolean): Only openings that are not closed, were seen in the last 5 days, and were found in the last year. Example: `false` - `not_closed` (boolean): Openings that are not closed, ignoring last seen. Example: `false` - `location` (string): Country name, or a US state name or abbreviation. Example: `` - `first_seen_at_from` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `first_seen_at_until` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `last_seen_at_from` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `last_seen_at_until` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `with_description_only` (boolean): Only openings that include a description. Example: `false` - `with_location_only` (boolean): Only openings that include a location. Example: `false` - `categories` (string): Comma-separated categories, such as sales,engineering. Example: `` - `page` (number): 1-based page. Example: `10` - `limit` (number): Openings to return, from 1 to 1000. The page price stays 10 credits. Example: `10` Response schema example: ```json { "data": [ { "id": "", "type": "", "attributes": {}, "relationships": {} } ] } ``` ### Technology detections - Capability: `companies/technology-detections` - Description: Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - Instructions: List technologies detected at a company, with where the evidence was seen. first_seen_at_from limits the list to technologies adopted since that date. One response costs 10 credits. A 404 costs nothing. - Cost: 10 credits per call - Capability file: [Technology detections](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/technology-detections) Accepted options: - `company_id_or_domain` (string, required): Company domain without a scheme, such as stripe.com, or a PredictLeads company id. Example: `` - `first_seen_at_from` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `first_seen_at_until` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `last_seen_at_from` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `last_seen_at_until` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `page` (number): 1-based page. Example: `10` - `limit` (number): Detections to return, from 1 to 1000. The page price stays 10 credits. Example: `10` Response schema example: ```json { "data": [ { "id": "", "type": "", "attributes": {}, "relationships": {} } ] } ``` ### News events - Capability: `companies/news-events` - Description: Records in data. included holds related objects when PredictLeads sends them. An empty data array is a successful response with no rows. - Instructions: List classified news events for a company: a category, a confidence score, and the sentence that triggered the event. found_at_from filters when PredictLeads found the event, not when the event happened. One response costs 10 credits. A 404 costs nothing. - Cost: 10 credits per call - Capability file: [News events](https://alexandria.firecrawl.dev/agents/providers/predictleads/companies/news-events) Accepted options: - `company_id_or_domain` (string, required): Company domain without a scheme, such as stripe.com, or a PredictLeads company id. Example: `` - `location` (string): Country name, or a US state name or abbreviation. Example: `` - `found_at_from` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `found_at_until` (string): ISO 8601 date, such as 2026-01-01. Example: `` - `categories` (string): Comma-separated event categories, such as partners_with,hires,receives_financing. Example: `` - `page` (number): 1-based page. Example: `10` - `limit` (number): Events to return, from 1 to 1000. The page price stays 10 credits. Example: `10` Response schema example: ```json { "data": [ { "id": "", "type": "", "attributes": {}, "relationships": {} } ] } ```