{ "openapi": "3.0.1", "info": { "title": "Super Lawyers Scraper — Attorney Leads & Awards", "description": "Attorney leads from the Super Lawyers directory: name, firm, practice areas, phone, website, office address, law school, year licensed — plus the Super Lawyers and Rising Stars selection years no other lawyer directory publishes. Filter by practice area, state, city and current selection.", "version": "0.1", "x-build-id": "KJHaPrnBZkd9usaw3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~superlawyers-attorney-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-superlawyers-attorney-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/scrapersdelight~superlawyers-attorney-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-superlawyers-attorney-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/scrapersdelight~superlawyers-attorney-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-superlawyers-attorney-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", "required": [ "proxyConfiguration" ], "properties": { "source": { "title": "What to crawl", "enum": [ "directory", "stateRoster", "profileUrls" ], "type": "string", "description": "Directory search = the attorneys.superlawyers.com listings built from the practice areas, states and cities you pick below. Best for a targeted lead list. State roster = every attorney Super Lawyers publishes in a state, read from that state's own roster file — best for full coverage of a market (California 27,420 attorneys, New York 22,751, Texas 15,888, Montana 278, measured 2026-08-12). Specific profile URLs = re-scrape or refresh a list you already have. The price per attorney is the same on all three.", "default": "directory" }, "practiceAreas": { "title": "Practice areas", "type": "array", "description": "Directory search only. All 140 practice areas Super Lawyers publishes, read from the site's own index on 2026-08-12 — pick as many as you like. Each state or city is crawled once per practice area, so five areas × three cities is fifteen listings to walk. Leave empty to take every practice area in the places you list. Ignored when Source is a state roster or profile URLs.", "items": { "type": "string", "enum": [ "administrative-law", "admiralty-and-maritime-law", "adoption", "agriculture-law", "alternative-dispute-resolution", "animal-bites", "animal-law", "antitrust-litigation", "appellate", "asbestos", "assault-and-battery", "auto-dealer-fraud", "aviation-accidents-plaintiff", "aviation-and-aerospace", "bad-faith-insurance", "banking", "bankruptcy", "birth-injury", "brain-injury", "business-and-corporate", "business-litigation", "business-organizations", "cannabis-law", "child-support", "civil-litigation", "civil-rights", "class-action-and-mass-torts", "closely-held-business", "collections", "communications", "constitutional-law", "construction-accident", "construction-defects", "construction-litigation", "consumer-law", "contracts", "credit-repair", "creditor-debtor-rights", "criminal-defense", "custody-and-visitation", "defamation", "disability", "discrimination", "divorce", "domestic-violence", "drug-and-alcohol-violations", "dui-dwi", "e-discovery", "elder-law", "eminent-domain", "employee-benefits", "employment-and-labor", "employment-law-employee", "employment-law-employer", "employment-litigation", "energy-and-natural-resources", "entertainment-and-sports", "environmental", "environmental-litigation", "estate-and-trust-litigation", "estate-planning-and-probate", "ethics-and-professional-responsibility", "family-law", "fathers-rights", "food-and-drugs", "foreclosure", "franchise-and-dealership", "gaming", "general-litigation", "government-contracts", "government-finance", "government-relations", "health-care", "immigration", "insurance-coverage", "insurance-defense", "intellectual-property", "intellectual-property-litigation", "international", "internet", "land-use-and-zoning", "landlord-and-tenant", "legal-aid-and-pro-bono", "legal-malpractice", "legislative-and-governmental-affairs", "lemon-law", "lobbying", "media-and-advertising", "mediation-and-collaborative-law", "medical-devices", "medical-malpractice", "mergers-and-acquisitions", "military-and-veterans-law", "military-divorce", "motor-vehicle-accidents", "motor-vehicle-defects", "native-american-law", "native-peoples-law", "natural-resources-law", "nonprofit-organizations", "nursing-home", "patents", "personal-injury-defense", "personal-injury-plaintiff", "premises-liability-plaintiff", "products-liability", "professional-liability", "professional-malpractice-other", "railroad-accident", "real-estate", "same-sex-family-law", "schools-and-education", "science-and-technology-law", "securities-and-corporate-finance", "securities-litigation", "sex-offenses", "sexual-abuse-plaintiff", "sexual-harassment", "social-security", "social-security-disability", "state-local-and-municipal", "surety", "tax", "technology-transactions", "toxic-mold", "toxic-torts", "trademarks", "traffic-violations", "transportation-and-maritime", "trucking-accidents", "trusts", "utilities", "veterans-benefits", "wage-and-hour-laws", "whistleblower", "white-collar-crimes", "wills", "workers-compensation", "wrongful-death", "wrongful-termination" ], "enumTitles": [ "Administrative Law", "Admiralty & Maritime Law", "Adoption", "Agriculture Law", "Alternative Dispute Resolution", "Animal Bites", "Animal Law", "Antitrust Litigation", "Appellate", "Asbestos", "Assault & Battery", "Auto Dealer Fraud", "Aviation Accidents - Plaintiff", "Aviation & Aerospace", "Bad Faith Insurance", "Banking", "Bankruptcy", "Birth Injury", "Brain Injury", "Business & Corporate", "Business Litigation", "Business Organizations", "Cannabis Law", "Child Support", "Civil Litigation", "Civil Rights", "Class Action & Mass Torts", "Closely Held Business", "Collections", "Communications", "Constitutional Law", "Construction Accident", "Construction Defects", "Construction Litigation", "Consumer Law", "Contracts", "Credit Repair", "Creditor Debtor Rights", "Criminal Defense", "Custody & Visitation", "Defamation", "Disability", "Discrimination", "Divorce", "Domestic Violence", "Drug & Alcohol Violations", "DUI-DWI", "E-Discovery", "Elder Law", "Eminent Domain", "Employee Benefits", "Employment & Labor", "Employment Law - Employee", "Employment Law - Employer", "Employment Litigation", "Energy & Natural Resources", "Entertainment & Sports", "Environmental", "Environmental Litigation", "Estate & Trust Litigation", "Estate Planning & Probate", "Ethics & Professional Responsibility", "Family Law", "Father's Rights", "Food & Drugs", "Foreclosure", "Franchise & Dealership", "Gaming", "General Litigation", "Government Contracts", "Government Finance", "Government Relations", "Health Care", "Immigration", "Insurance Coverage", "Insurance Defense", "Intellectual Property", "Intellectual Property Litigation", "International", "Internet", "Land Use & Zoning", "Landlord & Tenant", "Legal Aid & Pro Bono", "Legal Malpractice", "Legislative & Governmental Affairs", "Lemon Law", "Lobbying", "Media & Advertising", "Mediation & Collaborative Law", "Medical Devices", "Medical Malpractice", "Mergers & Acquisitions", "Military & Veterans Law", "Military Divorce", "Car Accident", "Motor Vehicle Defects", "Native American Law", "Native Peoples Law", "Natural Resources Law", "Nonprofit Organizations", "Nursing Home", "Patents", "Personal Injury - Defense", "Personal Injury", "Premises Liability - Plaintiff", "Products Liability", "Professional Liability", "Professional Malpractice - Other", "Railroad Accident", "Real Estate", "Same Sex Family Law", "Schools & Education", "Science & Technology Law", "Securities & Corporate Finance", "Securities Litigation", "Sex Offenses", "Sexual Abuse - Plaintiff", "Sexual Harassment", "Social Security", "Social Security Disability", "State, Local & Municipal", "Surety", "Tax", "Technology Transactions", "Toxic Mold", "Toxic Torts", "Trademarks", "Traffic Violations", "Transportation & Maritime", "Trucking Accidents", "Trusts", "Utilities", "Veteran's Benefits", "Wage & Hour Laws", "Whistleblower", "White Collar Crimes", "Wills", "Workers' Compensation", "Wrongful Death", "Wrongful Termination" ] } }, "states": { "title": "States", "type": "array", "description": "Super Lawyers covers the 50 states plus Washington DC and nothing else. The count next to each state is how many attorneys its roster file held on 2026-08-12 — that is the ceiling for a whole-state run, and your bill is capped by Max results, not by the roster size. Required for a state roster; for a directory search you can use states, cities, or both.", "items": { "type": "string", "enum": [ "alabama", "alaska", "arizona", "arkansas", "california", "colorado", "connecticut", "delaware", "washington-dc", "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 — 2,272 attorneys", "Alaska — 171 attorneys", "Arizona — 2,632 attorneys", "Arkansas — 907 attorneys", "California — 27,420 attorneys", "Colorado — 3,642 attorneys", "Connecticut — 2,915 attorneys", "Delaware — 610 attorneys", "District of Columbia (Washington DC) — 5,127 attorneys", "Florida — 12,305 attorneys", "Georgia — 5,909 attorneys", "Hawaii — 575 attorneys", "Idaho — 350 attorneys", "Illinois — 10,176 attorneys", "Indiana — 2,542 attorneys", "Iowa — 769 attorneys", "Kansas — 1,139 attorneys", "Kentucky — 1,821 attorneys", "Louisiana — 2,867 attorneys", "Maine — 618 attorneys", "Maryland — 3,765 attorneys", "Massachusetts — 7,008 attorneys", "Michigan — 5,226 attorneys", "Minnesota — 4,574 attorneys", "Mississippi — 1,078 attorneys", "Missouri — 3,925 attorneys", "Montana — 278 attorneys", "Nebraska — 582 attorneys", "Nevada — 1,523 attorneys", "New Hampshire — 511 attorneys", "New Jersey — 6,724 attorneys", "New Mexico — 677 attorneys", "New York — 22,751 attorneys", "North Carolina — 3,983 attorneys", "North Dakota — 317 attorneys", "Ohio — 6,658 attorneys", "Oklahoma — 1,953 attorneys", "Oregon — 1,996 attorneys", "Pennsylvania — 8,409 attorneys", "Rhode Island — 619 attorneys", "South Carolina — 1,795 attorneys", "South Dakota — 227 attorneys", "Tennessee — 2,526 attorneys", "Texas — 15,888 attorneys", "Utah — 1,524 attorneys", "Vermont — 276 attorneys", "Virginia — 3,660 attorneys", "Washington — 4,489 attorneys", "West Virginia — 746 attorneys", "Wisconsin — 2,621 attorneys", "Wyoming — 139 attorneys" ] } }, "cities": { "title": "Cities", "type": "array", "description": "Optional, directory search only. City slugs exactly as the site writes them — austin, houston, san-francisco, new-york, miami. Leave empty and a state-level listing is expanded into its city listings for you (that is the only level of this site that actually lists attorneys). When you pick several states, pair each city with its state (texas/austin, or \"Austin, TX\") or every city is tried in every state. Note the listings show attorneys SERVING a city, so a row's own city field is the attorney's actual office, which may be a nearby town.", "items": { "type": "string" } }, "rosterOrder": { "title": "State roster order", "enum": [ "richestFirst", "spread" ], "type": "string", "description": "State roster only, and it matters whenever you cap a big state. The roster file is ordered by profile tier: the front is the upgraded, fully-filled profiles, the back is the plain ones. Measured on California's 27,420 attorneys, 25 profiles from each position — the first 25 carried the achievements block on 92% of rows, an even sample across the file on 8%, the last 25 on 0%. Contact data barely moves (website 96% / 92% / 88%). \"Richest profiles first\" gives you the deepest rows; \"Even spread\" gives you a representative cross-section of the state, small towns included.", "default": "richestFirst" }, "profileUrls": { "title": "Attorney profile URLs", "type": "array", "description": "Full attorney profile URLs, e.g. https://profiles.superlawyers.com/texas/austin/lawyer/jane-doe/00000000-0000-0000-0000-000000000000.html. The UUID at the end identifies the attorney and is required. Firm (/lawfirm/) URLs are a firm page, not an attorney, and are rejected with an error rather than silently producing a half-empty row. Each URL is one fetch and, if it passes your filters, one charged row.", "items": { "type": "string" } }, "selectionType": { "title": "Selection list", "enum": [ "any", "superLawyers", "risingStars" ], "type": "string", "description": "Which peer-selection list an attorney must be on. Super Lawyers is the main list, capped at the top 5% of lawyers in a state. Rising Stars is the under-40 / first-ten-years list, capped at the top 2.5%. \"Any\" keeps both, which is what you want for coverage; Rising Stars alone is the classic legal-tech buying cohort. On a 200-attorney representative sample, 65.5% carried a Super Lawyers selection and 54.5% a Rising Stars one, so either cut roughly halves the rows a run returns — it fetches more profiles to fill your quota, at no extra charge to you.", "default": "any" }, "currentSelectionsOnly": { "title": "Only attorneys on the current list", "type": "boolean", "description": "Keep only attorneys whose most recent selection year is the current calendar year or later — i.e. they are on the list that is live right now, not one they made in 2014. Read against the list you picked above: with \"Rising Stars only\" it means currently a Rising Star, not currently selected to something. 58.5% of a 200-attorney representative sample were currently selected. Off by default, because a lapsed selectee is still a real firm with a real phone number.", "default": false }, "minYearsSelected": { "title": "Minimum years selected", "minimum": 0, "maximum": 40, "type": "integer", "description": "Keep only attorneys selected at least this many times. 1-2 finds the lawyers who have just made the list (the ones who buy badges, plaques and marketing); 10+ finds long-established partners. Counts the chosen selection list, or both lists combined when Selection list is \"Any\". Leave at 0 for everyone.", "default": 0 }, "minYearsLicensed": { "title": "Minimum years licensed", "minimum": 0, "maximum": 80, "type": "integer", "description": "Keep only attorneys licensed at least this many years, computed from the \"Licensed in since\" year on the profile (99.5% fill on a 200-attorney sample). Set 25+ for succession and retirement outreach, or leave at 0 for everyone.", "default": 0 }, "withPhoneOnly": { "title": "Only attorneys with a phone number", "type": "boolean", "description": "Keep only attorneys who publish a phone number. On by default because a lead you cannot ring is not a lead. Phone measured 100% on a 200-attorney representative sample and 99.3% on a 150-attorney directory sample, so this normally removes nothing.", "default": true }, "withWebsiteOnly": { "title": "Only attorneys with a website", "type": "boolean", "description": "Keep only attorneys who link a firm website (96.5% fill on the representative sample). Useful when you plan to enrich the domain for email afterwards, or when you sell to firms that already market online.", "default": false }, "includeAchievements": { "title": "Include the achievements detail", "type": "boolean", "description": "Include the honors, bar activity, certifications, industry groups, verdicts/settlements, pro bono, lectures and other-education arrays — eight fields, so the row goes from 61 columns to 53 when this is off. Only upgraded profiles fill these in — roughly 10% of a representative statewide sample, 32-36% of a directory search — so turning it off makes the rows leaner without losing much. No effect on price or run time.", "default": true }, "includeBiography": { "title": "Include the biography text", "type": "boolean", "description": "Include each attorney's full self-written biography. It is long — often 2,000+ characters — so it is off by default. Turn it on when you want copy for personalised outreach. No effect on price or run time.", "default": false }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Cap the number of attorneys returned. 100 rows = $0.30, 1,000 = $3.00, the whole California roster (27,420) = $82.26. The run stops the moment the cap is reached, mid-listing if need be. The first click is pre-filled at 25 (about $0.08) so you can see the rows before you commit; raise it once you like what comes back. A run that would outlast its own timeout stops early and saves what it has rather than dying — give a big cap a bigger timeout under Run options.", "default": 100 }, "maxPagesPerListing": { "title": "Max listing pages per search", "minimum": 1, "maximum": 400, "type": "integer", "description": "Directory search only: how deep to page through each practice-area/city listing before moving to the next. 25 attorneys per page. Raise it to go deeper in one city, or add more cities and practice areas for broader coverage. Listing pages are not charged — only attorneys returned are.", "default": 20 }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 4, "type": "integer", "description": "How many profile fetches may be in flight. Raising it will NOT make the run much faster: superlawyers.com answers roughly two requests a second per exit IP and then returns HTTP 429, so this Actor paces itself and slows down further whenever it is rate limited. Measured on one minted session: 1 worker at 700ms 20/20, 2 workers at 500ms 20/20, 3 workers at 300ms 18/25 (7× 429), 4 workers at 200ms 22/25. 2 is the sweet spot.", "default": 2 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "REQUIRED, and it must be Apify Proxy with the RESIDENTIAL group. superlawyers.com is behind Cloudflare bot management: measured 2026-08-12 through Apify, datacentre exits returned HTTP 403 on 20 of 20 requests, residential-with-rotating-sessions 6 of 20, and residential with the challenge cookie this Actor mints on the sitemap path 20 of 20. Leave this at the default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }