# Avvo Lawyer Directory Scraper

> Avvo Lawyer Directory Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.08/call, status unknown (last checked 2026-10-02).

Scrapes structured attorney profile data from Avvo's public lawyer directory by practice area and U.S. state, or from specific profile/directory URLs.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/avvo?utm_source=zero.xyz
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/avvo-lawyer-directory-scraper-531933d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3tCV-xfpExx1QoiSmcuCk

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 avvo-lawyer-directory-scraper-531933d9 -d '<json body>'
```

Example prompt: Pull me up to 50 personal-injury lawyer profiles from Avvo in California — I need each attorney's name, city, address, and postal code in a structured list.

## When to prefer this

Choose this endpoint when you need structured attorney profile data from Avvo's public directory, especially when filtering by U.S. state and legal practice area. It is the right choice for building legal professional databases, lead generation for legal services, or researching attorneys in a specific specialty and geography. Prefer it over generic web scrapers when Avvo-specific structured output (name, address, job title, postal code) is required without manual parsing.

## Known failure modes

- Empty result set if practice area or location combination returns no listings on Avvo
- Invalid or inaccessible start URL returns an error or empty items array
- Unsupported state or category enum value causes request rejection
- Avvo rate-limiting or anti-scraping measures may cause partial or failed runs (not charged)
- Malformed input schema (e.g. missing startUrls when searchByCategory is omitted) causes a validation error

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object containing a count of matched profiles and an array of attorney records, each including the lawyer's name, job title, city, state, address, postal code, profile URL, and an ID field. Results are capped by the requested limit and optional overall maximum.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Maximum unique lawyer profiles to save from each directory or URL."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Hard cap across all starting queries. Set to 0 for no overall cap."
  },
  "startUrls": {
   "type": "array",
   "description": "Public Avvo lawyer directory or individual attorney profile URLs. These may be combined with a practice-area search."
  },
  "searchByCategory": {
   "enum": [
    "bankruptcy-debt-lawyer",
    "consumer-protection-lawyer",
    "government-lawyer",
    "business-lawyer",
    "immigration-lawyer",
    "intellectual-property-lawyer",
    "criminal-defense-lawyer",
    "lawsuits-disputes-lawyer",
    "personal-injury-lawyer",
    "employment-labor-lawyer",
    "estate-planning-lawyer",
    "family-lawyer",
    "real-estate-lawyer",
    "civil-rights-lawyer"
   ],
   "type": "string",
   "description": "Practice area for a public lawyer directory search; pair with a U.S. state. Leave empty when only using start URLs."
  },
  "searchByLocation": {
   "enum": [
    "al",
    "ak",
    "az",
    "ar",
    "ca",
    "co",
    "ct",
    "de",
    "dc",
    "fl",
    "ga",
    "hi",
    "id",
    "il",
    "in",
    "ia",
    "ks",
    "ky",
    "la",
    "me",
    "md",
    "ma",
    "mi",
    "mn",
    "ms",
    "mo",
    "mt",
    "ne",
    "nv",
    "nh",
    "nj",
    "nm",
    "ny",
    "nc",
    "nd",
    "oh",
    "ok",
    "or",
    "pa",
    "ri",
    "sc",
    "sd",
    "tn",
    "tx",
    "ut",
    "vt",
    "va",
    "wa",
    "wv",
    "wi",
    "wy"
   ],
   "type": "string",
   "description": "Two-letter U.S. state for the practice-area search. Leave empty when only using start URLs."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "city": null,
    "name": null,
    "state": null,
    "address": null,
    "jobTitle": null,
    "postalCode": null
   }
  ],
  "product": "avvo"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/avvo-lawyer-directory-scraper-531933d9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)