{ "openapi": "3.0.1", "info": { "title": "Super Lawyers Scraper [From $2.5💰] | Attorney Data | Leads", "description": "Extract Super Lawyers attorney data for lead generation, CRM enrichment and legal market research. Get profiles, selections, Rising Stars flags, practice areas, firm data and contact details in structured rows - no official API needed. Runs via API, schedule or webhook.", "version": "0.1", "x-build-id": "6oepxtH4C619JbIaC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~superlawyers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-superlawyers-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/ahmed_jasarevic~superlawyers-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-superlawyers-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/ahmed_jasarevic~superlawyers-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-superlawyers-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": "Start URLs", "type": "array", "description": "Optional. Explicit directory listing URLs (https://attorneys.superlawyers.com////) or attorney profile URLs (https://profiles.superlawyers.com///lawyer//.html). When set, these override the state / practice-area filters.", "items": { "type": "string" } }, "profileUrls": { "title": "Attorney Profile URLs", "type": "array", "description": "Optional. Specific profiles.superlawyers.com attorney profile URLs to scrape directly, bypassing the directory crawl.", "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "Filter by U.S. state (2-letter code). Supports all 50 states + DC: AL=Alabama, AK=Alaska, AZ=Arizona, AR=Arkansas, CA=California, CO=Colorado, CT=Connecticut, DE=Delaware, DC=District of Columbia, FL=Florida, GA=Georgia, HI=Hawaii, ID=Idaho, IL=Illinois, IN=Indiana, IA=Iowa, KS=Kansas, KY=Kentucky, LA=Louisiana, ME=Maine, MD=Maryland, MA=Massachusetts, MI=Michigan, MN=Minnesota, MS=Mississippi, MO=Missouri, MT=Montana, NE=Nebraska, NV=Nevada, NH=New Hampshire, NJ=New Jersey, NM=New Mexico, NY=New York, NC=North Carolina, ND=North Dakota, OH=Ohio, OK=Oklahoma, OR=Oregon, PA=Pennsylvania, RI=Rhode Island, SC=South Carolina, SD=South Dakota, TN=Tennessee, TX=Texas, UT=Utah, VT=Vermont, VA=Virginia, WA=Washington, WV=West Virginia, WI=Wisconsin, WY=Wyoming. Leave empty to crawl every state.", "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" ] } }, "practiceAreas": { "title": "Practice Areas", "type": "array", "description": "Filter by practice-area slug, exactly as SuperLawyers serves it (see /gsm/pa.xml.gz for all 140). Correct slugs include: employment-and-labor, personal-injury-plaintiff, business-litigation, family-law, divorce, criminal-defense, immigration, bankruptcy, medical-malpractice, intellectual-property, civil-rights, mergers-and-acquisitions, dui-dwi, workers-compensation, real-estate, estate-planning-and-probate, tax, health-care, securities-and-corporate-finance, class-action-and-mass-torts, products-liability, construction-litigation, environmental, appellate, alternative-dispute-resolution, white-collar-crimes, drug-and-alcohol-violations, landlord-and-tenant, patents, trademarks, business-and-corporate. Common misspellings (tax-law, real-estate-law, mergers-acquisitions, product-liability, appeals, ...) are accepted and mapped to the real slug; anything else that does not exist on the site returns HTTP 404 and yields no rows. Leave empty to crawl a default set of 15 major areas.", "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "Filter by city using the SuperLawyers URL slug, e.g. los-angeles or new-york. Combine with States for precise targeting.", "default": "" }, "enrichProfiles": { "title": "Enrich Profiles", "type": "boolean", "description": "Visit each attorney profile page to add biography, practice and focus areas, selection years, bar activity, social links, firm website and firm ID. Recommended — listing pages only carry contact + firm data.", "default": true }, "findFirmEmails": { "title": "Find Firm Emails", "type": "boolean", "description": "Additionally crawl each law firm's own website (homepage + contact pages) and extract published contact e-mail addresses. Adds extra requests per firm.", "default": false }, "groupBy": { "title": "Output Shape", "enum": [ "attorney", "firm" ], "type": "string", "description": "'attorney' = one row per attorney. 'firm' = one row per law firm, grouped on SuperLawyers' own firm UUID, with a nested attorneys array. Firm output requires profile enrichment and turns it on automatically.", "default": "attorney" }, "includeAttorneys": { "title": "Include Attorneys Array", "type": "boolean", "description": "With firm output, nest each firm's attorneys inside its record. Turn off for smaller records when only firm-level fields are needed.", "default": true }, "maxItems": { "title": "Max Items", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of output rows (attorneys, or firms in firm mode). 0 = unlimited (the request ceiling is `maxRequestsPerCrawl`). Capped for free users.", "default": 0 }, "maxPagesPerListing": { "title": "Max Pages per Listing", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum directory result pages to follow per practice/state/city listing (via ). Each page yields up to 25 attorneys.", "default": 3 }, "maxRequestsPerCrawl": { "title": "Max Requests per Crawl", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard ceiling on HTTP requests for this run. A safety rail that prevents runaway crawls.", "default": 2000 }, "debugHtml": { "title": "Debug: Save Raw HTML", "type": "boolean", "description": "Save each raw HTML response to the key-value store and log a short excerpt. Useful for diagnosing Cloudflare interstitials; leave off for normal runs.", "default": false }, "requestDelaySecs": { "title": "Request delay (seconds)", "minimum": 0, "maximum": 10, "type": "number", "description": "Minimum gap between two requests to the site. SuperLawyers answers a fast burst with HTTP 429 for the whole IP; raise this if requests start failing with 429.", "default": 0.5 }, "listingsInKeyStore": { "title": "Save listing index", "type": "boolean", "description": "Write every directory page the crawl fetched (URL, page number, attorney count, HTTP status, bytes) to the key-value store under the key `LISTINGS`. Read it separately from the attorney dataset.", "default": true }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 } } } } } } } } } }