{ "openapi": "3.0.1", "info": { "title": "FindLaw Lawyer Scraper", "description": "[💰 $2.00 / 1K] Extract US lawyer and law firm profiles from FindLaw. Search by state and practice area, profile URL, or free-text query. Get names, firms, contact info, practice areas, experience, credentials, and ratings — with reviews optional. One row per profile.", "version": "1.0", "x-build-id": "byW63McCBOmVuHhgr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~findlaw-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~findlaw-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~findlaw-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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": { "profileUrls": { "title": "Profile URLs", "type": "array", "description": "FindLaw lawyer or law firm profile URLs (e.g. https://lawyers.findlaw.com/profile/view/1234567_1). Paste one URL per line. Each URL produces one profile row.", "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 profiles via FindLaw 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" ] } }, "practiceAreas": { "title": "Practice areas", "uniqueItems": true, "type": "array", "description": "Practice areas to filter by. Leave empty to cover all common areas (broad sweep). Combined with the states selection above.", "items": { "type": "string", "enum": [ "personal-injury", "criminal-defense", "divorce-separation", "family-law", "bankruptcy-debt", "employment-labor", "estate-planning", "business-law", "real-estate", "immigration", "dui-dwi", "intellectual-property", "tax-law", "medical-malpractice", "workers-compensation", "social-security-disability", "consumer-protection", "civil-rights" ], "enumTitles": [ "Personal Injury", "Criminal Defense", "Divorce & Separation", "Family Law", "Bankruptcy & Debt", "Employment & Labor", "Estate Planning & Probate", "Business & Commercial", "Real Estate", "Immigration", "DUI & DWI", "Intellectual Property", "Tax", "Medical Malpractice", "Workers' Compensation", "Social Security & Disability", "Consumer Protection", "Civil Rights" ] } }, "searchQueries": { "title": "Free-text search queries", "type": "array", "description": "Free-text queries like 'divorce lawyers, Austin TX' or 'personal injury attorney, Miami FL'. Each query is resolved against the FindLaw directory search. Use this when you don't have URLs or precise state + practice-area combos in hand.", "items": { "type": "string" } }, "maxResults": { "title": "Max profiles", "minimum": 0, "type": "integer", "description": "Cap on the total number of profile rows returned. Set to 0 (or leave empty) for no cap (internally limited to 50,000 rows). The actor stops requesting new directory pages once the cap is reached but keeps the full last page if it slightly overshoots. When multiple states and practice areas are selected, the actor sweeps every combination — narrow the selection if you only need a sample." }, "includeReviews": { "title": "Include client reviews", "type": "boolean", "description": "When ON, fetch client reviews for each profile and include them as a nested array on the profile row. When OFF, only the review summary (count + average rating) is returned. Turning this ON significantly increases run time and cost." }, "maxReviewsPerProfile": { "title": "Max reviews per profile", "minimum": 0, "maximum": 100, "type": "integer", "description": "Cap on the number of reviews captured per profile. Set to 0 to capture all available reviews (up to a safety ceiling of about 120 per profile); otherwise 1-100. Only applies when 'Include client reviews' is ON. 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 } } } } } } } } } }