---
canonical_url: "https://docs.composio.dev/toolkits/predict_leads"
markdown_url: "https://docs.composio.dev/toolkits/predict_leads.md"
product: "platform"
version: null
last_updated: null
---

# PredictLeads

PredictLeads provides company intelligence on hiring, technologies, financing, news, products, business connections, and other growth signals.

- **Category:** company data
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `PREDICT_LEADS`
- **Version:** 20261014_01
- **Instant:** Supported on the latest version. Support varies by tool.

## Tools

### Discover Companies

**Slug:** `PREDICT_LEADS_DISCOVER_COMPANIES`

Find companies using firmographic filters. Discovery costs one credit per returned record, so the default limit is 5. Deterministic upstream 4xx responses also consume credits and are not retried.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.04 per returned company

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number. Page numbering starts at 1. |
| `limit` | integer | No | Maximum companies on this page (1-1000). Each returned company costs one credit, so the conservative default is 5. |
| `sizes` | array | No | Employee-size bands to match. Accepts an array or comma-separated string; sent as one comma-separated query value. |
| `industry` | string | No | Industry text to match. |
| `location` | string | No | Company location to match. |
| `naics_codes` | array | No | NAICS codes to match. Accepts an array or comma-separated string; sent as one comma-separated query value. |
| `revenue_range_low` | integer | No | Minimum company revenue. Must not exceed revenue_range_high. |
| `revenue_range_high` | integer | No | Maximum company revenue. Must be at least revenue_range_low. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Discover Extended Companies

**Slug:** `PREDICT_LEADS_DISCOVER_EXTENDED_COMPANIES`

Discover exactly one page of PredictLeads extended company profiles. Each returned record costs 1 API credit (1x). Before discovery, call the free Get API Subscription action to check remaining credits. PredictLeads shares a 60 requests/second limit across API calls; after a rate-limit response, honor the provider's Retry-After header before retrying.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number. Page numbering starts at 1. |
| `limit` | integer | No | Maximum extended companies on this page (1-1000). Each returned record costs 1 API credit (1x), so the default is 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Discover Intelligence

**Slug:** `PREDICT_LEADS_DISCOVER_INTELLIGENCE`

Discover one page of jobs, technology adoption, news, financing, investor portfolio connections, products, or startup-platform posts across companies. Select exactly one dataset. Each returned record costs one credit, so the default limit is 5; deterministic upstream 4xx failures also consume credits.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.04 per intelligence record returned

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number, starting at 1. Always sent to obtain count metadata. |
| `limit` | integer | No | Maximum records on this page (1-1000). Each returned record costs one credit, so the conservative default is 5. |
| `title` | string | No | Job title filter. Valid only for job_openings. |
| `dataset` | string ("job_openings" | "technology_detections" | "news_events" | "financing_events" | "investor_connections" | "products" | "startup_platform_posts") | Yes | Cross-company intelligence dataset to discover from one fixed endpoint. |
| `location` | string | No | Job location for job_openings, or company location for news_events and financing_events. |
| `date_from` | string | No | Date start: first_seen_at for jobs, technology detections, or investor connections, and published_at for startup posts. |
| `seniority` | string ("not_set" | "founder" | "c_level" | "partner" | "president" | "vice_president" | "head" | "director" | "manager" | "mid_senior" | "junior") | No | Job seniority filter. Valid only for job_openings. |
| `date_until` | string | No | Date end for technology detections, investor connections, or startup posts. Jobs do not support an end date. |
| `onet_codes` | array | No | O*NET occupation codes for job_openings only. Accepts an array or comma-separated string and sends one CSV query value. |
| `post_types` | array | No | Startup post types, show_hn or job_hn, for startup_platform_posts only. Accepts an array or comma-separated string and sends one CSV query value. |
| `active_only` | boolean | No | Return active jobs only. Valid only for job_openings. |
| `company_sizes` | array | No | Company size bands for news_events only. Accepts an array or comma-separated string and sends one CSV query value. |
| `news_categories` | array | No | News-event categories, such as launches, hires, or receives_financing. Valid only for news_events and sent as one CSV query value. |
| `last_seen_at_from` | string | No | Last-seen start date for technology detections or investor connections. |
| `last_seen_at_until` | string | No | Last-seen end date for technology detections or investor connections. Must not precede last_seen_at_from. |
| `product_categories` | array | No | Product categories: product, service, solution, or unclassified. Valid only for products and sent as one CSV query value. |
| `product_subcategories` | array | No | Product subcategories only: industry, use_case, pricing_tier, or unclassified. Sent as one CSV query value. |
| `financing_types_normalized` | array | No | Normalized financing round types for financing_events only. Accepts an array or comma-separated string and sends one CSV query value. |
| `technology_id_or_fuzzy_name` | string | No | PredictLeads technology ID or fuzzy name. Required only for technology_detections and rejected for every other dataset. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Subscription

**Slug:** `PREDICT_LEADS_GET_API_SUBSCRIPTION`

Check PredictLeads subscription status, monthly credit quota, and credits used. This endpoint is free and should be called before or during credit-sensitive workflows.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company

**Slug:** `PREDICT_LEADS_GET_COMPANY`

Retrieve one company by PredictLeads UUID or bare domain. Each upstream response costs 1 credit, including deterministic 4xx failures, so malformed identifiers are rejected locally and 4xx errors should not be retried.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.04 per company lookup

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id_or_domain` | string | Yes | PredictLeads company UUID or bare company domain. URLs, paths, ports, blanks, and placeholder values are rejected before the credit-consuming request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company Intelligence

**Slug:** `PREDICT_LEADS_GET_COMPANY_INTELLIGENCE`

Retrieve one page of a company's jobs, technology detections, news, financing, SEC filings, connections, website changes, GitHub repositories, or products. Select exactly one dataset. Each call costs one credit, including deterministic upstream 4xx failures.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.04 per company intelligence lookup

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number. Always sent so response meta includes count. |
| `limit` | integer | No | Records on this page. Maximum 50 for sec_filings and 1000 otherwise. |
| `dataset` | string ("job_openings" | "technology_detections" | "news_events" | "financing_events" | "sec_filings" | "connections" | "website_evolution" | "github_repositories" | "products") | Yes | Company intelligence dataset to retrieve from one fixed endpoint. |
| `location` | string | No | Location filter. Valid only for job_openings or news_events. |
| `date_from` | string | No | Start date for found_at on news, filed_at on SEC filings, and first_seen_at on other datasets. |
| `date_until` | string | No | End date for found_at on news, filed_at on SEC filings, and first_seen_at on other datasets. Must not precede date_from. |
| `not_closed` | boolean | No | Exclude closed jobs. Valid only for job_openings. |
| `active_only` | boolean | No | Return active jobs only. Valid only for job_openings. |
| `job_categories` | array | No | Job-opening categories, such as engineering, sales, or software_development. Valid only for job_openings. Accepts an array or comma-separated string. |
| `news_categories` | array | No | News-event categories, such as launches, hires, or receives_financing. Valid only for news_events. Accepts an array or comma-separated string. |
| `last_seen_at_from` | string | No | Last-seen start date. Valid only for job_openings, technology_detections, or connections. |
| `last_seen_at_until` | string | No | Last-seen end date. Valid only for job_openings, technology_detections, or connections; must not precede its start. |
| `product_categories` | array | No | Product categories: product, service, solution, or unclassified. Valid only for products. Accepts an array or comma-separated string. |
| `with_location_only` | boolean | No | Require a job location. Valid only for job_openings. |
| `company_id_or_domain` | string | Yes | PredictLeads company UUID or bare domain. URLs, non-canonical UUID spellings, reserved test domains, and placeholders are rejected before the credit-consuming request. |
| `connection_categories` | array | No | Connection categories, such as partner, vendor, integration, or investor. Valid only for connections. Accepts an array or comma-separated string. |
| `product_subcategories` | array | No | Product subcategories: industry, use_case, pricing_tier, or unclassified. Valid only for products. Accepts an array or comma-separated string. |
| `with_description_only` | boolean | No | Require a job description. Valid only for job_openings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Extended Company

**Slug:** `PREDICT_LEADS_GET_EXTENDED_COMPANY`

Retrieve one extended company profile by PredictLeads UUID or bare domain. If the extended profile is not ready, PredictLeads can return empty data with an accepted message asking the caller to try again in 24 hours. Each upstream response costs 1 API credit (1x), so first run the free Get API Subscription action to confirm available credits. PredictLeads shares a 60-requests-per-second limit across API calls; after a 429, wait for the Retry-After interval before retrying.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id_or_domain` | string | Yes | PredictLeads company UUID or bare company domain. Invalid identifiers are rejected locally before the 1-credit request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Intelligence Record

**Slug:** `PREDICT_LEADS_GET_INTELLIGENCE_RECORD`

Retrieve one job opening, extended technology detection, technology, news event, SEC filing, or product by identifier. Select exactly one record type. Each call costs 1 credit; malformed identifiers are rejected locally because upstream 4xx responses also consume credits.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.04–$0.12 per intelligence record lookup (1–3 modeled credits)

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | Record UUID. For record_type='technology', a fuzzy technology name is also accepted. All other record types require a canonical hyphenated UUID. |
| `record_type` | string ("job_opening" | "extended_technology_detection" | "technology" | "news_event" | "sec_filing" | "product") | Yes | Kind of intelligence record to retrieve. Selects exactly one fixed endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Similar Companies

**Slug:** `PREDICT_LEADS_GET_SIMILAR_COMPANIES`

Find one page of companies similar to a specified PredictLeads company UUID or domain. Each returned record costs 1 credit, so the default limit is 5; deterministic 4xx responses are not retried.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.04 per similar company returned

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number. Must be at least 1; exactly one page is fetched. |
| `limit` | integer | No | Maximum similar-company records on this page (1-50). Each returned record costs 1 credit; default 5. |
| `company_id_or_domain` | string | Yes | PredictLeads company UUID or bare domain. Surrounding whitespace is removed; URLs, non-canonical UUID spellings, reserved test domains, blank values, and placeholders are rejected before the credit-consuming request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Followed Companies

**Slug:** `PREDICT_LEADS_LIST_FOLLOWED_COMPANIES`

List one page of companies already followed for PredictLeads webhook updates. This is read-only and does not change follow state. The operation costs 1 credit per response; deterministic 4xx failures are not retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number. Must be at least 1; exactly one page is fetched. |
| `limit` | integer | No | Maximum followed companies on this page (1-1000). Default 25. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Technologies

**Slug:** `PREDICT_LEADS_SEARCH_TECHNOLOGIES`

Search PredictLeads' tracked technology catalog by fuzzy name. This unusually expensive endpoint costs 3 API credits per returned record, so the default limit of 3 can cost up to 9 credits. Check API subscription usage first and do not retry deterministic 4xx failures. Exactly one provider page is fetched.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.12 per technology returned (3 modeled credit)

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number. Must be at least 1; exactly one page is fetched. |
| `limit` | integer | No | Maximum technologies on this page (1-1000). Each returned record costs 3 API credits; the default of 3 can cost up to 9 credits. |
| `order_by` | string ("created_at_asc" | "created_at_desc" | "fuzzy_score_desc") | No | Result ordering. Use fuzzy_score_desc for the most relevant fuzzy-name matches. |
| `fuzzy_name` | string | No | Technology name to search. Omit only when intentionally browsing the tracked technology catalog. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |