# How much does the PredictLeads company data API cost?

A PredictLeads company lookup costs $0.04 a response, however many items the response holds, while discovery searches, similar companies and the technologies list are charged per record returned, at $0.04 a record on Discover Companies. A discovery search sent without `limit` returns a default page, 30 records on most searches, and is billed for every one, so set `limit`. Call `GET https://agents.predictleads.com/zcj/4xoj2eg8mfxz/api/v3/companies/{id_or_domain}` or `GET https://agents.predictleads.com/zcj/4xoj2eg8mfxz/api/v3/discover/companies` and pay the 402 (the price quote, which you pay and then retry) over x402 or MPP, the wallet rails, with no account or API key.

## At a glance

- **Endpoints:** `GET https://agents.predictleads.com/zcj/4xoj2eg8mfxz/api/v3/companies/{id_or_domain}` for a company lookup, `GET https://agents.predictleads.com/zcj/4xoj2eg8mfxz/api/v3/discover/companies` for a company search.
- **Lookups:** charged per response. A company is $0.04. Its job openings, news events, financing events, technology detections, products, SEC filings, subpages and connections are each priced per response, as listed in the table below.
- **Searches:** charged per record returned. Discover Companies is $0.04 a record.
- **Default page:** 30 records on most discovery searches when no `limit` is sent (20 on similar companies, 100 on the technologies list). On Discover Companies, `limit` goes up to 1000.
- **Dearer meters:** extended company $0.08 a response, technology $0.12 a response, technologies list $0.12 a record, extended companies search $0.08 a record.
- **Pay per call:** x402 (Base USDC) or MPP (Tempo USDC), the wallet rails. No account, key or identity is needed. A card pays a single call of $0.50 or more.
- **Credits:** prepaid balance from $0.50, or $0.50 by card, at the same prices.
- **Live prices and full flow:** `https://agents.predictleads.com/zcj/4xoj2eg8mfxz/manifest.json` and [the buyer skill](https://agents.predictleads.com/zcj/4xoj2eg8mfxz/SKILL.md)

## Per-response lookups and per-record searches

| Call | Unit | Price |
| --- | --- | --- |
| Company, `GET /api/v3/companies/{id_or_domain}` | response | $0.04 |
| A company's job openings | response | $0.04 |
| A company's news events | response | $0.04 |
| A company's financing events | response | $0.04 |
| A company's technology detections | response | $0.04 |
| A company's products | response | $0.04 |
| A company's SEC filings | response | $0.04 |
| A company's subpages | response | $0.04 |
| A company's connections | response | $0.04 |
| Extended company | response | $0.08 |
| Technology | response | $0.12 |
| Discover companies, `GET /api/v3/discover/companies` | record | $0.04 |
| Discover job openings | record | $0.04 |
| Discover companies using a technology | record | $0.04 |
| Discover extended companies | record | $0.08 |
| Similar companies | record | $0.04 |
| Technologies list | record | $0.12 |

A long list of job openings costs the same as a short one. The page size is what sets a search's cost.

## Worked costs

- 100 company lookups: $4.
- One Discover Companies search with no `limit`, returning 30 records: $1.20.
- The same search with `limit=3`: $0.12.

```http
GET https://agents.predictleads.com/zcj/4xoj2eg8mfxz/api/v3/discover/companies?location=United%20States&sizes=51-200&limit=3
```

This request paid $0.12 for three records. The response is a JSON object whose `data` list holds one `company` object per record, each with `domain`, `company_name`, `location` and `location_data`.

## Ways to pay and when you are charged

- Nothing is charged until the 402 is paid. Comparing prices in the manifest needs no registration or payment setup.
- Pay per call over x402 or MPP. The signed payment identifies you, so no registration is needed.
- A card can pay a single call only when that call costs $0.50 or more. For cheaper calls by card, buy Credits and draw each call from the balance; Credits need the free agent credential, and [the buyer skill](https://agents.predictleads.com/zcj/4xoj2eg8mfxz/SKILL.md) covers buying and topping them up.

## Frequently asked questions

### Does a company lookup cost more when it returns more items?

No. Lookups such as a company's job openings or news events are charged once per response at that meter's price, whatever the number of items in the response.

### What does a search cost if I do not set limit?

A discovery search without `limit` returns a default page of 30 records and charges for each one. On Discover Companies that is $1.20. Send `limit` set to the number of records you need.

### Do Credits lower the price per call?

No. Credits carry the same per-response and per-record prices as pay per call. They let you fund a balance once, including by card from $0.50, and then draw it down call by call.

### Do I need an account or API key to pay per call?

No. Pay-per-call requests settle the 402 over x402 or MPP with no signup, no key and no bearer credential. A bearer credential is needed only to buy or top up Credits.

### How do I see what a call was charged?

Every paid response carries a `zc-billing` header. On a call funded by Credits, `chargedUsd` is the amount debited and `remainingCreditUsd` is the balance left.

## Keep reading

- [The buyer skill](https://agents.predictleads.com/zcj/4xoj2eg8mfxz/SKILL.md): the full purchase flow
- [Services and prices](https://agents.predictleads.com/zcj/4xoj2eg8mfxz/services): every dataset and its meters
- [How to pay](https://agents.predictleads.com/zcj/4xoj2eg8mfxz/payment.md): x402, MPP, card and Credits
- [Error reference](https://agents.predictleads.com/zcj/4xoj2eg8mfxz/errors.md): payment and access errors

---

Updated 2026-10-28. All PredictLeads guides: https://agents.predictleads.com/guides.md. Storefront: https://agents.predictleads.com/zcj/4xoj2eg8mfxz/llms.txt.
