# Angi Top-Rated Pros Lookup

> Angi Top-Rated Pros Lookup is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns top-rated Angi (Angie's List) contractors for a given service category in a US city, including ratings, reviews, business details, and profile links.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/b2b/angies-list?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/angi-top-rated-pros-lookup-81730c1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u9pg3iYoZJgIgBBQPCyC0

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 angi-top-rated-pros-lookup-81730c1a
```

Example prompt: Can you pull up the top-rated plumbers on Angi in Austin, TX? I want to see their ratings, review counts, and whether they offer free estimates.

## When to prefer this

Use this endpoint when you need detailed contractor profiles — including sub-ratings, flags (veteran, emergency, warranty), payment methods, and real reviews — for a specific home-service category in a US city, sourced from Angi's curated top-rated list. Prefer this over generic business search APIs (like BBB or Yelp) when you specifically want Angi's rating methodology and pro attributes, or when you need to surface the recommend rate and Angi profile links for home services.

## Known failure modes

- Unknown or unsupported service slug returns empty results or error
- City/state combination not found on Angi returns empty list
- Angi page structure changes may break scraping and return malformed data
- Residential proxy failure may result in timeout or blocked request
- Very small markets may have no listed pros and return an empty array

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A structured list of top-rated pros for the requested service in the given city, including business name, overall star rating, review count, recommend percentage, sub-ratings (quality, value, punctuality, etc.), years in business, geographic details (city/state/ZIP), service area coverage, boolean flags for emergency availability, free estimates, warranty, and veteran-owned status, accepted payment methods, list of services offered, a highlighted top review, and a direct Angi profile URL. Also includes the city's aggregate rating for that service category.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "service",
      "city",
      "state"
     ],
     "properties": {
      "city": {
       "type": "string",
       "description": "City name, e.g. austin or 'san antonio'"
      },
      "state": {
       "type": "string",
       "description": "Two-letter US state code, e.g. tx"
      },
      "service": {
       "type": "string",
       "description": "Angi service slug, e.g. plumbing, electrical, roofing, house-cleaning, hvac"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/angi-top-rated-pros-lookup-81730c1a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)
