{ "openapi": "3.0.1", "info": { "title": "California State Bar Attorney Scraper", "description": "Scrape California State Bar attorney profiles: name, license status, firm, address, phone, website, law school, admission date, practice areas, specialties, languages and full discipline history. Search by county, city, practice area, language or license number.", "version": "1.0", "x-build-id": "4g32LxWBCOhH4pclN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~calbar-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-calbar-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/normdata~calbar-scraper/runs": { "post": { "operationId": "runs-sync-normdata-calbar-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/normdata~calbar-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-calbar-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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many attorneys. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "counties": { "title": "Counties", "type": "array", "description": "Attorneys whose address is in ANY of these California counties (\"Non-California\" = addresses outside the state).", "items": { "type": "string", "enum": [ "ZZ", "AL", "AP", "AM", "BU", "CA", "CO", "CC", "DN", "ED", "FR", "GL", "HM", "IM", "IN", "KN", "KI", "LK", "LS", "LA", "MA", "MR", "MP", "MN", "MC", "MD", "MO", "MT", "NP", "NV", "OR", "PL", "PM", "RV", "SA", "SO", "SR", "SD", "SF", "SJ", "SP", "SM", "SB", "SC", "SZ", "SH", "SI", "SK", "SL", "SN", "ST", "SU", "TE", "TR", "TU", "TL", "VN", "YO", "YU" ], "enumTitles": [ "Non-California", "Alameda", "Alpine", "Amador", "Butte", "Calaveras", "Colusa", "Contra Costa", "Del Norte", "El Dorado", "Fresno", "Glenn", "Humboldt", "Imperial", "Inyo", "Kern", "Kings", "Lake", "Lassen", "Los Angeles", "Madera", "Marin", "Mariposa", "Mendocino", "Merced", "Modoc", "Mono", "Monterey", "Napa", "Nevada", "Orange", "Placer", "Plumas", "Riverside", "Sacramento", "San Benito", "San Bernardino", "San Diego", "San Francisco", "San Joaquin", "San Luis Obispo", "San Mateo", "Santa Barbara", "Santa Clara", "Santa Cruz", "Shasta", "Sierra", "Siskiyou", "Solano", "Sonoma", "Stanislaus", "Sutter", "Tehama", "Trinity", "Tulare", "Tuolumne", "Ventura", "Yolo", "Yuba" ] } }, "cities": { "title": "Cities", "type": "array", "description": "Attorneys in ANY of these cities, e.g. \"San Diego\". One per line.", "items": { "type": "string" } }, "cityMatch": { "title": "City match", "enum": [ "begins", "exact", "contains", "soundsLike" ], "type": "string", "description": "How the city is matched. Begins with when not set." }, "states": { "title": "States", "type": "array", "description": "Attorneys whose address is in ANY of these US states (many California attorneys live elsewhere).", "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" ] } }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Attorneys in ANY of these 5 digit ZIP codes. One per line.", "items": { "type": "string" } }, "practiceAreas": { "title": "Practice areas", "type": "array", "description": "Attorneys who report ANY of these practice areas (self-reported to the State Bar).", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "65", "34", "35", "36", "37", "38", "39", "40", "41", "42", "66", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52", "53", "54", "55", "56", "57", "58", "59", "60", "61", "62", "63", "64" ], "enumTitles": [ "Administrative Law", "Admiralty & Maritime Law", "Agriculture Law", "Alternative Dispute Resolution", "Antitrust & Trade Regulation", "Appellate Practice", "Aviation & Aerospace", "Banking Law", "Bankruptcy", "Business Law", "Civil Rights", "Class Actions", "Commercial Law", "Communications Law", "Constitutional Law", "Construction Law", "Contracts", "Corporate Law", "Criminal Law", "Debtor & Creditor", "Education Law", "Elder Law", "Election, Campaign & Political", "Eminent Domain", "Employee Benefits", "Energy", "Entertainment & Sports", "Environmental Law", "Family Law", "Finance", "Government", "Government Contracts", "Health Care", "Homeowner Association Law", "Immigration", "Indians & Native Populations", "Insurance", "Intellectual Property", "International Law", "International Trade", "Internet Law", "Investments", "Labor & Employment", "Landlord-Tenant Law", "Legal Malpractice", "Litigation", "Media Law", "Medical Malpractice", "Mergers & Acquisitions", "Military Law", "Natural Resources", "Occupational Safety & Health", "Personal Injury", "Products Liability", "Professional Liability", "Real Estate", "Securities", "Taxation", "Technology & Science", "Toxic torts", "Transportation", "Trusts & Estates", "Wills & Probate", "White Collar Crime", "Workers Compensation", "Zoning, Planning & Land Use" ] } }, "specialties": { "title": "Certified legal specialties", "type": "array", "description": "Attorneys certified as specialists in ANY of these areas.", "items": { "type": "string", "enum": [ "10", "08", "07", "101", "102", "103", "104", "01", "105", "106", "06", "04", "107", "09", "05", "111", "11", "109", "110", "112", "03", "02" ], "enumTitles": [ "Admiralty and Maritime Law", "Appellate Law", "Bankruptcy Law", "Business Bankruptcy Law", "Civil Trial Advocacy", "Consumer Bankruptcy Law", "Creditor's Rights Law", "Criminal Law", "Criminal Trial Advocacy", "Elder Law", "Estate Planning, Trust & Probate Law", "Family Law", "Family Law Trial Advocacy", "Franchise & Distribution Law", "Immigration & Nationality Law", "Juvenile Law (Child Welfare)", "Legal Malpractice Law", "Legal Professional Liability", "Medical Professional Liability", "Social Security Disability Law", "Taxation Law", "Workers' Compensation Law" ] } }, "languagesSpoken": { "title": "Languages spoken", "type": "array", "description": "Attorneys listed as speaking ANY of these languages.", "items": { "type": "string", "enum": [ "6", "50", "51", "49", "7", "8", "9", "52", "53", "54", "55", "48", "56", "10", "39", "57", "58", "59", "60", "61", "43", "62", "41", "63", "11", "64", "44", "12", "65", "13", "14", "15", "66", "16", "17", "18", "19", "45", "67", "68", "69", "20", "70", "21", "71", "72", "5", "73", "22", "74", "75", "76", "77", "2", "78", "79", "80", "81", "23", "82", "46", "83", "84", "85", "86", "87", "24", "25", "26", "27", "42", "28", "29", "30", "88", "31", "89", "90", "91", "92", "32", "1", "93", "47", "94", "3", "40", "33", "34", "35", "95", "96", "97", "36", "98", "37", "99", "4", "38" ], "enumTitles": [ "African languages", "Afrikaans", "Albanian", "American Sign Language (ASL)", "Amharic", "Arabic", "Armenian", "Bantu", "Belarusian", "Bengali", "Bisayan", "Bulgarian", "Burmese", "Cambodian", "Cantonese", "Chamorro", "Chinese", "Croatian", "Cushite", "Czech", "Danish", "Dutch", "Esperanto", "Estonian", "Farsi", "Fijian", "Finnish", "French", "French Creole", "German", "Greek", "Gujarati", "Hawaiian", "Hebrew", "Hindi", "Hmong", "Hungarian", "Icelandic", "Ilocano", "Indonesian", "Irish Gaelic", "Italian", "Jamaican Creole", "Japanese", "Kannada", "Karen", "Korean", "Kurdish", "Laotian", "Latvian", "Lithuanian", "Malay", "Malayalam", "Mandarin", "Marathi", "Mayan languages", "Mien", "Mongolian", "Navajo", "Nepali", "Norwegian", "Other Native North American languages", "Pampangan", "Pangasinan", "Panjabi", "Pashto", "Persian", "Polish", "Portuguese", "Punjabi", "Romanian", "Russian", "Samoan", "Scandinavian languages", "Serbian", "Serbo-Croatian", "Sindhi", "Sinhalese", "Slovak", "Slovene", "Somali", "Spanish", "Swahili", "Swedish", "Syriac", "Tagalog", "Taiwanese", "Tamil", "Telugu", "Thai", "Tibetan", "Tongan", "Trukese", "Turkish", "Ukrainian", "Urdu", "Uyghur", "Vietnamese", "Yiddish" ] } }, "lastName": { "title": "Last name", "type": "string", "description": "e.g. \"Garcia\"." }, "lastNameMatch": { "title": "Last name match", "enum": [ "begins", "exact", "contains", "soundsLike" ], "type": "string", "description": "Begins with when not set." }, "firstName": { "title": "First name", "type": "string", "description": "e.g. \"Maria\"." }, "firstNameMatch": { "title": "First name match", "enum": [ "begins", "exact", "contains", "soundsLike" ], "type": "string", "description": "Begins with when not set." }, "middleName": { "title": "Middle name", "type": "string", "description": "Middle name or initial." }, "middleNameMatch": { "title": "Middle name match", "enum": [ "begins", "exact", "contains", "soundsLike" ], "type": "string", "description": "Begins with when not set." }, "firmName": { "title": "Firm name", "type": "string", "description": "e.g. \"Latham\"." }, "firmNameMatch": { "title": "Firm name match", "enum": [ "begins", "exact", "contains" ], "type": "string", "description": "Contains when not set." }, "statuses": { "title": "License status", "type": "array", "description": "Keep only ANY of these statuses. The search filters find active attorneys only; the other statuses need the license number range.", "items": { "type": "string", "enum": [ "active", "inactive", "notEligible", "disbarred", "resigned" ], "enumTitles": [ "Active", "Inactive", "Not eligible to practice law", "Disbarred", "Resigned" ] } }, "admittedFrom": { "title": "Admitted from (year)", "minimum": 1880, "maximum": 2100, "type": "integer", "description": "Keep only attorneys admitted to the California bar in this year or later." }, "admittedTo": { "title": "Admitted to (year)", "minimum": 1880, "maximum": 2100, "type": "integer", "description": "Keep only attorneys admitted in this year or earlier." }, "lawSchool": { "title": "Law school contains", "type": "string", "description": "Keep only attorneys from a law school whose name contains these words, e.g. \"Hastings\" or \"UCLA\"." }, "discipline": { "title": "Discipline record", "enum": [ "any", "with", "without" ], "type": "string", "description": "Any when not set. \"With\" keeps attorneys with any public discipline or charges in their history; \"Without\" keeps a clean record." }, "withPhoneOnly": { "title": "With phone only", "type": "boolean", "description": "Keep only attorneys with a phone number." }, "withWebsiteOnly": { "title": "With website only", "type": "boolean", "description": "Keep only attorneys with a website." }, "certifiedSpecialistsOnly": { "title": "Certified specialists only", "type": "boolean", "description": "Keep only attorneys certified as legal specialists." }, "licenseNumberFrom": { "title": "License number from", "minimum": 1, "type": "integer", "description": "First license number. 1 when only \"to\" is set." }, "licenseNumberTo": { "title": "License number to", "minimum": 1, "type": "integer", "description": "Last license number. Leave empty to read up to the newest license." }, "licenses": { "title": "Profile links or license numbers (filters ignored with links)", "type": "array", "description": "apps.calbar.ca.gov/attorney/Licensee/Detail/123456 links, or license numbers like 123456. One per line.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional, off by default. The State Bar site works without one. Proxy traffic is billed to your Apify account." } } }, "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 } } } } } } } } } }