{ "openapi": "3.0.1", "info": { "title": "Avvo Scraper — Lawyer & Attorney Leads", "description": "Scrape Avvo lawyer leads at scale. Search any practice area and location, then enrich every result with phone numbers, emails, firm websites, ratings, reviews and license details. Clean structured JSON or CSV, streamed live — ready for legal marketing, lead-gen agencies and CRM enrichment.", "version": "0.0", "x-build-id": "mo502fenG3vjmxg5i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_leads~Avvo-Real-Time-Data-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_leads-Avvo-Real-Time-Data-Scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/b2b_leads~Avvo-Real-Time-Data-Scraper/runs": { "post": { "operationId": "runs-sync-b2b_leads-Avvo-Real-Time-Data-Scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/b2b_leads~Avvo-Real-Time-Data-Scraper/run-sync": { "post": { "operationId": "run-sync-b2b_leads-Avvo-Real-Time-Data-Scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "enableSearch": { "title": "Search", "type": "boolean", "description": "Find lawyers by practice area and location. Enabled by default.", "default": true }, "searchTasks": { "title": "Search tasks", "type": "array", "description": "Add one row per search. Pair a practice area with a city and state.", "items": { "type": "object", "properties": { "practiceArea": { "title": "Practice area", "type": "string", "description": "Practice area slug (e.g. \"personal-injury\", \"family-law\", \"criminal-defense\", \"divorce\", \"bankruptcy\", \"immigration\").", "editor": "textfield" }, "location": { "title": "Location", "type": "string", "description": "City + state for this search (e.g. \"Austin, TX\", \"Chicago, IL\"). Use a US state code after the comma.", "editor": "textfield" }, "lawyersPerTask": { "title": "Max lawyers", "type": "integer", "description": "Maximum lawyers for this task. Uses the global default below if omitted.", "minimum": 1, "editor": "number" } }, "required": [ "practiceArea", "location" ] } }, "lawyersPerTask": { "title": "Default max lawyers per task", "minimum": 1, "type": "integer", "description": "Default maximum lawyers per search task. Override per task in the list above.", "default": 10 }, "maxDepthPerTask": { "title": "Max depth per task", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum depth to collect for each search task (safety cap for very large runs).", "default": 20 }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only keep lawyers rated at least this high (0–5). Leave empty for no filter." }, "enableLeadDetails": { "title": "Enable lead details", "type": "boolean", "description": "Visit each lawyer's profile to add phone, firm name, practice areas, years licensed, and — when listed — the firm website, then scan the firm's own site for emails and social profiles. Adds a little extra time per lawyer. Recommended for outreach and CRM enrichment.", "default": true }, "crawlFirmSites": { "title": "Find emails on firm websites", "type": "boolean", "description": "When a profile lists the firm's website, scan that site for contact emails and social profiles. Requires lead details. Adds a little extra time per lawyer with a website.", "default": true }, "enableProfileUrls": { "title": "Lawyer Profiles by URL", "type": "boolean", "description": "Enrich specific Avvo profile URLs you already have.", "default": false }, "profileUrls": { "title": "Profile URLs", "type": "array", "description": "Avvo lawyer profile URLs (one per line).", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max total items", "minimum": 1, "type": "integer", "description": "Global cap on total dataset rows across all features. Set high for large runs (e.g. 10000+).", "default": 10000 }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. Every record is always saved to the run's dataset — this webhook is an ADDITIONAL real-time push. When set, each new record is also POSTed to this URL (CRM, Slack incoming webhook, Zapier, Make, Google Sheets).", "default": "" }, "webhookFormat": { "title": "Webhook format", "enum": [ "json", "slack" ], "type": "string", "description": "json = full record object; slack = Slack-friendly message payload.", "default": "json" }, "proxyConfiguration": { "title": "Proxy settings", "type": "object", "description": "A residential US proxy connection is enabled by default for reliable collection.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }