# Avvo Lawyer Directory Scraper (x402)

> Avvo Lawyer Directory Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.08/call, status unknown (last checked 2026-10-02).

Scrapes structured attorney profile data from Avvo by practice area, U.S. state, or specific directory/profile URLs, returning lawyer names, locations, and contact details.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-x402-8e9821c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6JiN2O_wVDPvaEqRNAxWE

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-x402-8e9821c4 -d '<json body>'
```

Example prompt: Pull me up to 50 immigration lawyer profiles from Avvo in California — I need their names, cities, and addresses in structured format.

## When to prefer this

Choose this endpoint when you need structured, filterable attorney data from Avvo — particularly when filtering by U.S. state and practice area (e.g. bankruptcy, immigration, family law). It is preferable over general web scrapers because it returns a clean, typed schema of lawyer profiles rather than raw HTML. Use it when building legal professional databases, enriching CRM data with attorney contacts, or finding qualified lawyers in a specific jurisdiction.

## Known failure modes

- Invalid or non-Avvo URLs cause empty results with no charge
- Unsupported practice area enum value returns a validation error
- State code not matching enum causes a bad request error
- Avvo blocks or rate-limits the scrape resulting in an empty or partial response (not charged if empty)
- Exceeding maxItems cap truncates results early

## How this service works

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

## Output

Returns a JSON object with a count and an array of attorney profile items, each containing the lawyer's name, job title, city, state, address, postal code, Avvo profile URL, and Avvo ID. The product field confirms the data source as 'avvo'.

## 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-x402-8e9821c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)