# PredictLeads Discover Companies
> PredictLeads Discover Companies is a paid API for AI agents from agents.predictleads.com, paid per call via MPP, $0.12/call, status down (last checked 2026-10-30, last successful call 2026-10-27).
Returns a paginated list of companies filtered by location, company size, industry, NAICS codes, and revenue range, ordered by last updated date.
## Facts
- Endpoint: GET https://agents.predictleads.com/api/v3/discover/companies?utm_source=zero.xyz
- Price: $0.12/call
- Payment: MPP
- Status: down
- Last checked: 2026-10-30
- Last successful call: 2026-10-27
- Success rate: 100% of calls made through Zero
- Activations on Zero: 3
- Provider: agents.predictleads.com
- Website: https://agents.predictleads.com
- Canonical page: https://www.zero.xyz/c/agents-predictleads-com-predictleads-discover-companies-5daeb684
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L14txafSbVwiDoU6ZVo-3
Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.
## How to call it through Zero
Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):
```sh
zero fetch --capability agents-predictleads-com-predictleads-discover-companies-5daeb684
```
Example prompt: Can you find me a list of mid-size software companies (51-200 employees) headquartered in California that work in the Artificial Intelligence industry? Show me the first 30 results.
## When to prefer this
Use this endpoint when you need to discover and enumerate companies based on firmographic criteria — location, headcount, industry, NAICS codes, or revenue — rather than looking up a specific known company. It is ideal for building prospect lists, conducting market research, or mapping a competitive landscape across a defined segment. Prefer this over a single-company lookup when the goal is broad discovery across many companies rather than deep data on one.
## Known failure modes
- Invalid or unsupported location name returns empty results
- Unrecognized industry enum value returns a 422 validation error
- Invalid NAICS code returns a validation error
- Exceeding limit of 1000 per page returns an error
- Missing or invalid authentication token returns 401
- Network timeout on large result sets
- Estimated count may be inaccurate for niche filter combinations
## How this service works
Returns a list of companies filtered by their location and size, ordered by last updated date.
**NOTE**: This endpoint returns an estimated count of all results.
## Output
A paginated array of company objects, each including the company's domain, name, stock ticker, primary and additional location data (city, state, country, coordinates, address), a plain-language business description, meta title, industry, language, and timestamps. The response also includes an estimated total result count when a page number is supplied.
## Request schema (JSON Schema)
```json
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number of shown items.\n
\n**NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for\nperformance reasons.\n"
},
"limit": {
"type": "integer",
"default": 30,
"maximum": 1000,
"description": "Limit the number of shown items per page."
},
"sizes": {
"type": "array",
"items": {
"enum": [
"1",
"2-10",
"11-50",
"51-200",
"201-500",
"501-1000",
"1001-5000",
"5001-10000",
"10001+"
],
"type": "string"
},
"example": [
"1",
"2-10",
"11-50"
],
"description": "One or more valid company sizes.\n\n"
},
"industry": {
"enum": [
"Abrasives and Nonmetallic Minerals Manufacturing",
"Accessible Architecture and Design",
"Accessible Hardware Manufacturing",
"Accommodation and Food Services",
"Accounting",
"Administration of Justice",
"Administrative and Support Services",
"Advertising Services",
"Agricultural Chemical Manufacturing",
"Agriculture, Construction, Mining Machinery Manufacturing",
"Air, Water, and Waste Program Management",
"Airlines and Aviation",
"Alternative Dispute Resolution",
"Alternative Fuel Vehicle Manufacturing",
"Alternative Medicine",
"Ambulance Services",
"Amusement Parks and Arcades",
"Animal Feed Manufacturing",
"Animation",
"Animation and Post-production",
"Apparel & Fashion",
"Apparel Manufacturing",
"Appliances, Electrical, and Electronics Manufacturing",
"Architectural and Structural Metal Manufacturing",
"Architecture and Planning",
"Armed Forces",
"Artificial Intelligence",
"Artificial Rubber and Synthetic Fiber Manufacturing",
"Artists and Writers",
"Arts & Crafts",
"Audio and Video Equipment Manufacturing",
"Automation Machinery Manufacturing",
"Automotive",
"Aviation & Aerospace",
"Aviation and Aerospace Component Manufacturing",
"Baked Goods Manufacturing",
"Banking",
"Bars, Taverns, and Nightclubs",
"Bed-and-Breakfasts, Hostels, Homestays",
"Beverage Manufacturing",
"Biomass Electric Power Generation",
"Biotechnology",
"Biotechnology Research",
"Blockchain Services",
"Blogs",
"Boilers, Tanks, and Shipping Container Manufacturing",
"Book Publishing",
"Book and Per
… (truncated)
```
## Response schema (JSON Schema)
```json
{
"type": "object",
"title": "CompaniesDataset",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"example": {
"data": [
{
"id": "4d621799-d317-58ba-a967-d09e07a5391f",
"type": "company",
"attributes": {
"domain": "hubspot.com",
"ticker": "NYSE:HUBS",
"language": "en",
"location": "Challaghatta, Bengaluru, Karnataka, India",
"meta_title": "HubSpot | Software & Tools for your Business - Homepage",
"description": "HubSpot develops and markets a customer platform intended for businesses. The organization provides software tools focused on marketing, sales, customer service, and website management. By unifying these functions, the organization allows different corporate teams to maintain a shared view of customer interactions. The organization operates globally with a headquarters in the United States and additional offices in various international cities.",
"company_name": "HubSpot, Inc.",
"location_data": [
{
"city": "Bangalore",
"state": null,
"county": "Bangalore",
"country": "India",
"category": "headquarters",
"latitude": 12.970541,
"location": "Challaghatta, Bengaluru, Karnataka, India",
"zip_code": null,
"continent": "Asia",
"longitude": 77.604785,
"admin_area": "Karnataka",
"fuzzy_match": true,
"street_address": null
},
{
"city": "Bogotá",
"state": null,
"county": "Bogotá, D.C.",
"country": "Colombia",
"category": "headquarters",
"latitude": 4.635456,
"location": "Bogotá, Colombia",
"zip_code": null,
"continent": "South America",
"longitude": -74.08768,
"admin_area": "Bogota D.C.",
"fuzzy_match": false,
"street_address": null
},
{
"city": "Singapore",
"state": null,
"county": "Singapore",
"country": "Singapore",
"category": "headquarters",
"latitude": 1.285691,
"location": "1 George Street, Singapore 049145",
"zip_code": "049145",
"continent": "Asia",
"longitude": 103.847729,
"admin_area": "Singapore",
"fuzzy_match": false,
"street_address": "1 George Street"
},
{
"city": "Dublin",
"state": null,
"county": "Fingal",
"country": "Ireland",
"category": "headquarters",
"latitude": 53.346318,
"location": "1 Sir John Rogerson's Qu
… (truncated)
```
## More
- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-predictleads-com-predictleads-discover-companies-5daeb684/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.predictleads.com](https://www.zero.xyz/host/agents.predictleads.com/llms.txt)