---
title: "PredictLeads API: pricing, rate limits & MCP | ONEGTMLAB"
description: "PredictLeads API: Company-intelligence API on 120M+ companies: news events, job openings, technology detections, financing, SEC filings, products, key…"
canonical: https://www.onegtmlab.dev/tool-directory/signals/predictleads
---

# PredictLeads API: pricing, rate limits & MCP | ONEGTMLAB

[](/)

[

Book a call

](/book)

![](/_astro/predictleads.M8zXWdNb.svg)

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

[

See pricing

](#pricing)[

PredictLeads API docs

](https://docs.predictleads.com/v3)

At a glance

Category

Signals, Enrichment, Data platform

Pricing model

Credits

Free tier

100 API credits/month free (in-app plan name: 'Trial Plan'

Auth

API key

Official MCP

Yes

Best for

Account signals for trigger outreach

[predictleads.com ↗](https://predictleads.com)[Pricing page ↗](https://predictleads.com/pricing)

## 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 includedPlan details

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

### 101-5,000 API calls

[Price not verified](https://predictleads.com/pricing)

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

API includedPlan details

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

### 5,001-10,000 API calls

[Price not verified](https://predictleads.com/pricing)

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

API includedPlan details

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

### 10,001-100,000 API calls

[Price not verified](https://predictleads.com/pricing)

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

API includedPlan details

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

### 100,001-500,000 API calls

[Price not verified](https://predictleads.com/pricing)

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

API includedPlan details

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

### 500,001+ API calls

[Price not verified](https://predictleads.com/pricing)

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

API includedPlan 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.

1.  Create a PredictLeads account. The Free (in-app: "Trial Plan") plan includes API access.
2.  Sign up at [predictleads.com/sign\_up](https://predictleads.com/sign_up), verify email, copy key + token from [predictleads.com/subscriptions](https://predictleads.com/subscriptions)
3.  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 `https://oauth.predictleads.com/token`) also supported.
4.  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](https://docs.predictleads.com/)

API reference

[docs.predictleads.com/v3](https://docs.predictleads.com/v3)

OpenAPI spec

[docs.predictleads.com/schemas/open\_api\_schema.json](https://docs.predictleads.com/schemas/open_api_schema.json)

llms.txt

[predictleads.com/llms.txt](https://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.

[

![](/_astro/clearcue.C9H58fxL.svg)

Clearcue

Signals

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

Clearcue API review →](/tool-directory/signals/clearcue-ai)[

![](/_astro/openfunnel.CTHR_rPr.svg)

OpenFunnel

Signals

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 →](/tool-directory/signals/openfunnel)[

![](/_astro/theirstack.Cfe10y4N_JLnR5.webp)

TheirStack

Signals

Free planOfficial MCP

Best for hiring signals.

TheirStack API review →](/tool-directory/signals/theirstack)

## Before you build

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

-   **Confirm the API is on your plan**The 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 code**API 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 `https://oauth.predictleads.com/token`) also supported.
    
-   **Design around the rate limit**60 requests per second per API key; HTTP 429 with Retry-After when exceeded (llms.txt).
    
-   **Know the catch before you scale**Credits 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.

[

Book a call

](/book)[

See case studies

](/case-studies)

Read from [predictleads.com/pricing](https://predictleads.com/pricing), [docs.predictleads.com/v3](https://docs.predictleads.com/v3) and [predictleads.com/llms.txt](https://predictleads.com/llms.txt). Verified 25 Oct 2026.

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

**Base URL:** `https://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)

[](/)

© 2026 ONEGTMLAB Private Limited. All rights reserved.

COMPANY

[

Why Us

](/#why-us)[

Process

](/#timeline)[

Blogs

](/blogs)[

About

](/about)[

Clients

](/clients)[

Free resources

](/free-resources)[

Newsletter

](/newsletter)

Services

[

GTM Engineering

](/ai-gtm-engineering)[

Account-Based Marketing

](/services/account-based-marketing)[

Paid Media

](/services/paid-media)[

Content Engineering

](/linkedin-personal-branding)[

RevOps

](/services/revops)[

SEO, AEO & GEO

](/services/seo-aeo-geo)[

All services

](/services)

![](/_astro/wordmark-3d.CMEfGdYr.svg)
