{ "openapi": "3.0.1", "info": { "title": "FindLaw.com Lawyer Directory Scraper", "description": "Scrape lawyers.findlaw.com — one row per firm with every office address (lat/long), every attorney on staff, practice areas, website, and price range. Multi-select practice × state × city, or paste any FindLaw URL. JSON/CSV, billed per result.", "version": "0.0", "x-build-id": "hqW4r8MUIrsCD5Rhe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~findlaw-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-findlaw-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/memo23~findlaw-scraper/runs": { "post": { "operationId": "runs-sync-memo23-findlaw-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/memo23~findlaw-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-findlaw-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": { "startUrls": { "title": "FindLaw URLs", "type": "array", "description": "Paste any lawyers.findlaw.com URL — listing pages (`/{practice-area}/{state}/{city}/`) and direct firm/attorney URLs (`/{state}/{city}/{firm-slug}-{base64-id}/`) are auto-classified. Takes precedence over the practice-area / state / city dropdowns below — clear this list to use the dropdowns.", "items": { "type": "string" } }, "searchByCategory": { "title": "Practice areas", "uniqueItems": true, "type": "array", "description": "Select one or more practice areas. Combined with U.S. states + optional cities below as a cartesian product (e.g. 2 areas × 3 states × 2 cities = 12 listing URLs). ⚠️ Ignored when the FindLaw URLs field above is non-empty.", "items": { "type": "string", "enum": [ "brain-injury", "business-commercial-law", "collaborative-law", "criminal-law", "custody-visitation", "divorce", "drug-crime", "dui-dwi", "education-law", "elder-law", "employment-law-employee", "estate-planning", "family-law", "immigration-naturalization-law", "litigation-appeals", "medical-malpractice", "motor-vehicle-accidents-plaintiff", "nursing-home-abuse", "personal-injury-plaintiff", "probate-estate-administration", "real-estate-law", "sex-crime", "sexual-harassment", "social-security-disability", "taxation-law", "traffic-violations", "trusts", "wills", "workers-compensation-law", "wrongful-death-plaintiff", "wrongful-termination" ], "enumTitles": [ "Brain Injury", "Business / Commercial Law", "Collaborative Law", "Criminal Law", "Custody / Visitation", "Divorce", "Drug Crime", "DUI / DWI", "Education Law", "Elder Law", "Employment Law (employee)", "Estate Planning", "Family Law", "Immigration / Naturalization", "Litigation / Appeals", "Medical Malpractice", "Motor-Vehicle Accidents (plaintiff)", "Nursing-Home Abuse", "Personal Injury (plaintiff)", "Probate / Estate Administration", "Real Estate Law", "Sex Crime", "Sexual Harassment", "Social Security Disability", "Taxation Law", "Traffic Violations", "Trusts", "Wills", "Workers Compensation", "Wrongful Death (plaintiff)", "Wrongful Termination" ] } }, "searchByLocation": { "title": "U.S. states", "uniqueItems": true, "type": "array", "description": "Select one or more U.S. states (full state names as slugs). Combined with practice areas above as a cartesian product. Empty = national listings (one per practice area). ⚠️ Ignored when the FindLaw URLs field is non-empty.", "items": { "type": "string", "enum": [ "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" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "Dist. 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" ] } }, "searchByCity": { "title": "Cities (optional)", "type": "array", "description": "Optional city slugs (e.g. `los-angeles`, `san-francisco`, `new-york`). When set, narrows the listing URL to `/{practice-area}/{state}/{city}/`. Cities must be valid for the chosen state(s); FindLaw uses lowercase-hyphenated city names. ⚠️ Ignored when the FindLaw URLs field is non-empty.", "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Hard cap on the number of firm/attorney profiles collected across all listings. FindLaw listings paginate ~30 per page; the scraper follows pagination automatically until this cap is hit.", "default": 1000 }, "liteMode": { "title": "Lite mode (~30× faster, ~30× cheaper — name + phone + city/state only)", "type": "boolean", "description": "When enabled, the scraper skips per-firm detail fetches and emits one row per card directly from the listing's JSON-LD `LegalService` items. ~30× faster and ~30× cheaper (one listing fetch yields ~30 rows). Trade-off: rows have name + telephone + image + city/state/country only — no full address, no geo coordinates, no employees, no multiple offices, no website, no practice areas, no description.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "type": "integer", "description": "Maximum number of firm detail pages processed in parallel.", "default": 10 }, "minConcurrency": { "title": "Min concurrency", "minimum": 1, "type": "integer", "description": "Minimum number of firm detail pages processed in parallel.", "default": 1 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "type": "integer", "description": "Number of retries before a failed request is given up.", "default": 5 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. FindLaw serves Cloudflare on listing + detail pages — a US residential pool is strongly recommended.", "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 } } }, "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 } } } } } } } } } }