Skip to main content
PredictLeads logo
  • Category: company data
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: PREDICT_LEADS
  • Version: 20261030_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: PREDICT_LEADS_DISCOVER_COMPANIESFind companies using firmographic filters. Charged per returned record, so the default limit is 5. Deterministic upstream 4xx responses are also charged and are not retried.Instant: Supported on the latest version.Instant pricing: $0.04 per returned companyDiscount: 75

Input Parameters

integer
Provider page number. Page numbering starts at 1.
integer
Maximum companies on this page (1-1000). Charged per returned company, so the conservative default is 5.
array
Employee-size bands to match. Accepts an array or comma-separated string; sent as one comma-separated query value.
string
Industry text to match.
string
Company location to match.
array
NAICS codes to match. Accepts an array or comma-separated string; sent as one comma-separated query value.
integer
Minimum company revenue. Must not exceed revenue_range_high.
integer
Maximum company revenue. Must be at least revenue_range_low.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_DISCOVER_EXTENDED_COMPANIESDiscover exactly one page of PredictLeads extended company profiles. Charged per returned record. 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

integer
Provider page number. Page numbering starts at 1.
integer
Maximum extended companies on this page (1-1000). Charged per returned record, so the default is 1.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_DISCOVER_INTELLIGENCEDiscover one page of jobs, technology adoption, news, financing, investor portfolio connections, products, or startup-platform posts across companies. Select exactly one dataset. Charged per returned record, so the default limit is 5; deterministic upstream 4xx failures are also charged.Instant: Supported on the latest version.Instant pricing: $0.04 per intelligence record returnedDiscount: 75

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_GET_API_SUBSCRIPTIONCheck PredictLeads subscription status, monthly credit quota, and credits used. This endpoint is free and should be called before or during credit-sensitive workflows.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_GET_COMPANYRetrieve 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 lookupDiscount: 75

Input Parameters

string
required
PredictLeads company UUID or bare company domain. URLs, paths, ports, blanks, and placeholder values are rejected before the charged request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_GET_COMPANY_INTELLIGENCERetrieve 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 is charged, including deterministic upstream 4xx failures.Instant: Supported on the latest version.Instant pricing: $0.04 per company intelligence lookupDiscount: 75

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_GET_EXTENDED_COMPANYRetrieve 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 is charged, 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

string
required
PredictLeads company UUID or bare company domain. Invalid identifiers are rejected locally before the charged request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_GET_INTELLIGENCE_RECORDRetrieve 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 are also charged.Instant: Supported on the latest version.Instant pricing: $0.04 per record lookup; $0.12 for technology records.Discount: 75

Input Parameters

string
required
Record UUID. For record_type=‘technology’, a fuzzy technology name is also accepted. All other record types require a canonical hyphenated UUID.
string ("job_opening" | "extended_technology_detection" | "technology" | "news_event" | "sec_filing" | "product")
required
Kind of intelligence record to retrieve. Selects exactly one fixed endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_GET_SIMILAR_COMPANIESFind 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 returnedDiscount: 75

Input Parameters

integer
Provider page number. Must be at least 1; exactly one page is fetched.
integer
Maximum similar-company records on this page (1-50). Each returned record costs 1 credit; default 5.
string
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_LIST_FOLLOWED_COMPANIESList one page of companies already followed for PredictLeads webhook updates. This is read-only and does not change follow state. Each response is charged; deterministic 4xx failures are not retried.

Input Parameters

integer
Provider page number. Must be at least 1; exactly one page is fetched.
integer
Maximum followed companies on this page (1-1000). Default 25.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PREDICT_LEADS_SEARCH_TECHNOLOGIESSearch PredictLeads’ tracked technology catalog by fuzzy name. This endpoint costs 3 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: $0.12 per technology returned; empty pages are free.Discount: 75

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not