{ "openapi": "3.0.1", "info": { "title": "Avvo Lawyer Scraper", "description": "[💰 $1.3 / 1K] Extract US lawyer profiles from Avvo by state and practice area, by profile URL, or by free-text search. Captures name, firm, location, license info, fees, endorsements, awards, languages, bar admissions, and Avvo rating. Optionally include client reviews inline.", "version": "1.0", "x-build-id": "50NsC0lkebbeOcgJC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~avvo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-avvo-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/solidcode~avvo-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-avvo-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/solidcode~avvo-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-avvo-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": { "attorneyUrls": { "title": "Attorney profile URLs", "type": "array", "description": "Avvo profile URLs (e.g. https://www.avvo.com/attorneys/94104-ca-john-doe-12345.html). Paste one URL per line. Each URL produces one attorney row.", "default": [], "items": { "type": "string" } }, "states": { "title": "US states", "uniqueItems": true, "type": "array", "description": "Two-letter US state codes (e.g. CA, NY, TX). Leave empty to cover all 50 states + DC. Combined with the practice-area selection below to discover attorneys via Avvo directory pages.", "items": { "type": "string", "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" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] }, "default": [] }, "practiceAreas": { "title": "Practice areas", "uniqueItems": true, "type": "array", "description": "Practice areas to filter by. Leave empty to cover all 16 common areas (broad sweep). Combined with the states selection above.", "items": { "type": "string", "enum": [ "personal-injury", "criminal-defense", "divorce-separation", "family", "bankruptcy-debt", "employment", "estate-planning", "business", "real-estate", "immigration", "dui", "intellectual-property", "tax", "medical-malpractice", "landlord-tenant", "social-security" ], "enumTitles": [ "Personal Injury", "Criminal Defense", "Divorce & Separation", "Family", "Bankruptcy & Debt", "Employment & Labor", "Estate Planning", "Business", "Real Estate", "Immigration", "DUI & DWI", "Intellectual Property", "Tax", "Medical Malpractice", "Landlord & Tenant", "Social Security & Disability" ] }, "default": [] }, "lawyerSearch": { "title": "Free-text search queries", "type": "array", "description": "Free-text queries like 'divorce lawyers, San Francisco CA' or 'John Smith attorney, Austin TX'. Each query is resolved to its top matching Avvo profile. Use this when you don't have URLs or precise state + practice-area combos in hand.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max attorneys", "minimum": 0, "type": "integer", "description": "Cap on the total number of attorney rows returned. Set to 0 (or leave empty) for no cap. The actor stops requesting new directory pages once the cap is reached but keeps the full last page if it slightly overshoots. Practical ceiling is ~20,000 attorneys per state x practice-area cell (1,000 directory pages x ~20 attorneys per page) — beyond that, narrow the state + practice-area selection.", "default": 100 }, "includeReviews": { "title": "Include client reviews", "type": "boolean", "description": "When ON, fetch client reviews for each attorney and include them as a nested array on the attorney row. When OFF, only the review summary (count + average rating) is returned. Turning this ON significantly increases run time and cost.", "default": false }, "maxReviewsPerAttorney": { "title": "Max reviews per attorney", "minimum": 0, "maximum": 100, "type": "integer", "description": "Cap on the number of reviews captured per attorney. Set to 0 for unlimited; otherwise 1-100. Only applies when 'Include client reviews' is ON. Default 10.", "default": 10 } } }, "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 } } }, "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 } } } } } } } } } }