API review

PredictLeads API review

Company-intelligence API on 120M+ companies: news events, job openings, technology detections, financing, SEC filings, products, key customers, similar companies, GitHub and website subpages. Best for account signals for trigger outreach.

Verified 25 Oct 2026 · 35 endpoints listed · Official MCP server

PredictLeads API docs

What a call costs

The actions you pay for, as PredictLeads prices them in credits.

Action	Cost	Per
Company-specific request (job openings, news, tech detections, financing, SEC, connections, subpages, products, GitHub, company)	1	credit per response (up to 1,000 records where limit max is 1,000; SEC filings max 50)
Extended company (GET /extended_companies/{id})	2	credits per response
Discovery endpoint result	1	credit per record returned (2 per record for /discover/extended_companies)
Similar companies	1	credit per returned company (max 50 per page)
Technologies catalog (GET /technologies) / single technology	3	credits per record / per response
Follow a company (POST /follow)	0	free request
Followed company (webhook signals)	1 to 10	credits per company per month. Pricing page calculator text: each signal 1 credit, min 1, max 10 per company per month; the same page's FAQ says 1 credit per followed company per month
Pagination	1	credit per page

Show all 9 priced actionsHide the rest

Action	Cost	Per
Account endpoints (/api_subscription, /api_request_logs)	0	free

Pricing, plan by plan

US dollars, as PredictLeads's pricing page shows them on 25 Oct 2026. Monthly and annual billing are shown apart.

Free tier 100 API credits/month free (in-app plan name: 'Trial Plan'; webhooks not available until you upgrade)

Free (in-app: "Trial Plan")

$0

Free

1-100 credits/month at $0/credit; $0

API included

Plan details

Requests beyond the monthly limit return HTTP 402; credits do not roll over

101-5,000 API calls

Price not verified

101-5,000 credits/month at $0.04/credit; $40 minimum monthly charge

API included

Plan details

Requests beyond the monthly limit return HTTP 402; credits do not roll over

5,001-10,000 API calls

Price not verified

5,001-10,000 credits/month at $0.02/credit

API included

Plan details

Requests beyond the monthly limit return HTTP 402; credits do not roll over

10,001-100,000 API calls

Price not verified

10,001-100,000 credits/month at $0.01/credit

API included

Plan details

Requests beyond the monthly limit return HTTP 402; credits do not roll over

100,001-500,000 API calls

Price not verified

100,001-500,000 credits/month at $0.004/credit

API included

Plan details

Requests beyond the monthly limit return HTTP 402; credits do not roll over

500,001+ API calls

Price not verified

500,001+ credits/month at $0.002/credit

API included

Plan details

Requests beyond the monthly limit return HTTP 402; credits do not roll over

Show all 7 plansShow fewer plans

Enterprise (Flat files + webhooks, all datasets)

Custom quote

track unlimited companies via flat files; real-time webhooks

API included

Tiers are GRADUATED: each band is priced separately (first 100 free, 101-5,000 at $0.04, 5,001-10,000 at $0.02,...), and a $40 minimum applies once usage passes 100 credits. Source: the pricing-page calculator code (PRICING_TIERS, MINIMUM_FEE_PRICE = 40.0). Example: 10,000 credits = 4,900 × $0.04 + 5,000 × $0.02 = $296.

Rate limits

60 requests per second per API key; HTTP 429 with Retry-After when exceeded (llms.txt).

More on limitsLess

Monthly credit quota per plan; at the cap every request returns HTTP 402 and consumes nothing. Live: no rate-limit headers are returned on 200 responses.

How to get an API key

PredictLeads uses API key. The steps below follow PredictLeads's own docs.

Create a PredictLeads account. The Free (in-app: "Trial Plan") plan includes API access.
Sign up at predictleads.com/sign_up, verify email, copy key + token from predictleads.com/subscriptions
Send it with every request: header X-Api-Key + X-Api-Token, or HTTP Basic base64(api_key:api_token), or query ?api_key=&api_token=; OAuth2 client credentials (token URL oauth.predictleads.com/token) also supported.
Make a first call: Get followed companies. Keep the key in an environment variable, never in the command.
```
curl -X GET "https://predictleads.com/api/v3/followings" \
  -H "X-Api-Key: $PREDICTLEADS_API_KEY"
```

Where the docs live

What	Where
Documentation	docs.predictleads.com
API reference	docs.predictleads.com/v3
OpenAPI spec	docs.predictleads.com/schemas/open_api_schema.json
llms.txt	predictleads.com/llms.txt
Base URL	`https://predictleads.com/api/v3`
MCP server	`https://mcp.predictleads.com/`

Strengths and limits

Where it fits

Account signals for trigger outreach (46 news event types, financing, hiring)
Per-company enrichment where one request returns up to 1,000 records for 1 credit
Key-customer / vendor / partner connections mined from logos
Lookalikes with a stated reason
Website subpage text (pricing, about, products) as Markdown

Where it falls short

People or contact data
Very cheap discovery at scale: discovery endpoints bill per result, not per request

Worth knowing

Credits do not roll over; unused credits expire each billing period.
After the 100 free calls there is a $40 minimum monthly charge.
Discovery endpoints and similar companies bill per result, so a 1,000-row discovery page costs 1,000 credits, not 1.
Every pagination page is another credit.
Following a company costs at least 1 credit per month even with no signals.

7 moreShow fewer

Hitting the monthly limit returns HTTP 402.
Two credentials (key + token) are needed on every call.
The docs site is a single 10 MB page; /guide/* URLs return the same page.
Webhooks need any paid (upgraded) plan, capped at 5 webhook URLs; flat files need sales.
Not every request is 1 credit: /extended_companies costs 2 per response, /discover/extended_companies 2 per record, and the /technologies catalog 3 per record, so paging the full catalog at limit=1000 costs 3,000 credits a page.
Default page sizes are small (100 on company endpoints, 30 on discovery, 20 on similar companies, 10 on SEC filings); set limit (max 1,000; 50 for similar companies and SEC filings) to get the most from each credit (OpenAPI).
The pricing page contradicts itself on following: calculator text says 1 credit per webhook signal (min 1, max 10 per company per month), FAQ says 1 credit per followed company per month.

Who should use it

Use PredictLeads for: Account signals for trigger outreach (46 news event types, financing, hiring)
Look elsewhere for: People or contact data

If PredictLeads is not the answer

Other Signals tools in this directory, each with its own review.

Best for pre-templated, AI-filtered high-intent signals such as Asking for Recommendations, Frustration Expression and Agency….

Clearcue API review

Free planOfficial MCP

Best for finding lookalike companies from 1-10 seed domains or a plain-English description, up to 100 sync / 10,000 async.

OpenFunnel API review

Free planOfficial MCP

Best for hiring signals.

TheirStack API review

Before you build

Four things to settle first, each read off PredictLeads's own pages.

Confirm the API is on your planThe Free (in-app: "Trial Plan") plan includes API access. Free tier: 100 API credits/month free (in-app plan name: 'Trial Plan'.
Keep the key out of your codeAPI key. It is sent as: header X-Api-Key + X-Api-Token, or HTTP Basic base64(api_key:api_token), or query ?api_key=&api_token=; OAuth2 client credentials (token URL oauth.predictleads.com/token) also supported.
Design around the rate limit60 requests per second per API key; HTTP 429 with Retry-After when exceeded (llms.txt).
Know the catch before you scaleCredits do not roll over; unused credits expire each billing period.

Want us to build it for you?

Tell us what you want PredictLeads to do in your stack. We will show you how we would wire it into your data, outbound or CRM, and what we would check first.

See case studies

Read from predictleads.com/pricing, docs.predictleads.com/v3 and predictleads.com/llms.txt. Verified 25 Oct 2026.

All 35 endpointsFor developers: method, path, what it does and what it costs.

Base URL: predictleads.com/api/v3

Bulk and async: Flat files: JSONL via S3, GCS or SFTP; enterprise/contact sales

Webhooks: Triggered only for followed companies. Available on all upgraded (paid) subscription plans: up to 5 webhooks on the Trigger Subscriptions page; more via sales. Not available on the free Trial Plan (live app: 'Please upgrade your subscription plan to be able to add webhooks'). Endpoint must accept POST/PUT/PATCH/DELETE and answer 200 within 5 seconds.

Filter endpoints

35 endpoints

Method	Path	What it does	Cost
GET	`/followings`	Get followed companies	1 credit / response (docs label)
POST	`/companies/{company_id_or_domain}/follow`	Follow the company	Free request (docs label); the followed company is then billed monthly for webhook signals (see pricing.unit_costs)
DELETE	`/companies/{company_id_or_domain}/follow`	Unfollow the company	1 credit / response (docs label)
GET	`/companies/{id_or_domain}`	Get Company	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/discover/companies`	Discover Companies	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/extended_companies/{id_or_domain}`	Get Extended Company	2 credits / response (docs label)
GET	`/discover/extended_companies`	Discover Extended Companies	2 credits / record (docs label)
GET	`/companies/{company_id_or_domain}/similar_companies`	Get Similar Companies	1 credit per similar company returned (docs label "1 Credit / Record"; limit default 20, max 50)
GET	`/companies/{company_id_or_domain}/job_openings`	Get Job Openings	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/job_openings/{id}`	Get a single Job Opening by ID	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/discover/job_openings`	Discover Job Openings	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/companies/{company_id_or_domain}/technology_detections`	Get Technology Detections	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/discover/technologies/{technology_id_or_fuzzy_name}/technology_detections`	Discover Companies using a Technology	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/extended_technology_detections/{id}`	Get a single Extended Technology Detection by ID	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/technologies`	Get all tracked Technologies	3 credits per technology record returned (docs label "3 Credits / Record"); a full 1,000-row page = 3,000 credits
GET	`/technologies/{id_or_fuzzy_name}`	Get a single Technology by ID or fuzzy name	3 credits / response (docs label)
GET	`/companies/{company_id_or_domain}/news_events`	Get News Events	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/news_events/{id}`	Get a single News Event by ID	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/discover/news_events`	Discover News Events	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/companies/{company_id_or_domain}/financing_events`	Get Financing Events	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/discover/financing_events`	Discover Financing Events	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/companies/{company_id_or_domain}/sec_filings`	Get SEC Filings	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/sec_filings/{id}`	Get a single SEC Filing by ID	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/companies/{company_id_or_domain}/connections`	Get Connections	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/discover/portfolio_companies/connections`	Discover Portfolio Companies	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/discover/public_companies/connections`	Discover Public Companies Connections	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/companies/{company_id_or_domain}/subpages`	Get Subpages	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/companies/{company_id_or_domain}/github_repositories`	Get Github Repositories	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/discover/github_repositories`	Discover Github Repositories	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/companies/{company_id_or_domain}/products`	Get Products	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/products/{id}`	Get a single Product by ID	1 credit per response (docs label "1 Credit / Response"); each paginated page is another credit
GET	`/discover/products`	Discover Products	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/discover/startup_platform_posts`	Discover Startup Platform Posts	1 credit per record returned (docs label "1 Credit / Record"; limit max 1,000 per page)
GET	`/api_subscription`	Get API subscription information	Free (docs label; /api_subscription also measured free 2026-10-25)
GET	`/api_request_logs`	Get API request logs	Free (docs label)