{ "openapi": "3.0.1", "info": { "title": "DentalPlans.com Dentist Scraper — US Dental Provider Directory", "description": "Scrape DentalPlans.com to extract US dentist listings by ZIP code — practice name, provider name, specialties, phone, address, coordinates, plans accepted, smile points, and online booking availability. Filter by radius, gender, language, specialty, and booking. JSON or CSV out.", "version": "0.0", "x-build-id": "mNPPW0S4bE2fRnRNt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~dentalplans-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-dentalplans-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~dentalplans-scraper/runs": { "post": { "operationId": "runs-sync-memo23-dentalplans-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~dentalplans-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-dentalplans-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": { "zipCodes": { "title": "ZIP codes", "type": "array", "description": "One or more 5-digit US ZIP codes to search. The actor queries the DentalPlans API for each ZIP and returns all dentists within the radius. Example: [\"90210\", \"10001\"].", "default": [ "90210" ], "items": { "type": "string" } }, "radius": { "title": "Search radius (miles)", "enum": [ "5", "10", "20", "50" ], "type": "string", "description": "Distance from each ZIP code to search. Allowed values: 5, 10, 20, 50.", "default": "10" }, "searchTerm": { "title": "Dentist or practice name", "type": "string", "description": "Filter results to dentists or practices matching this name. Leave blank for all providers in the area.", "default": "" }, "dentistGender": { "title": "Dentist gender", "enum": [ "", "male", "female" ], "type": "string", "description": "Filter by dentist gender. Leave blank for any.", "default": "" }, "dentistLanguage": { "title": "Dentist language", "enum": [ "", "english", "spanish" ], "type": "string", "description": "Filter by language spoken. Leave blank for any.", "default": "" }, "dentistSpeciality": { "title": "Specialties", "type": "array", "description": "Filter by dental specialty. Enter one or more of: 1 (General Dentistry), 2 (Endodontics), 3 (Oral Surgery), 4 (Orthodontics), 5 (Pedodontics), 6 (Periodontics), 7 (Prosthodontics).", "default": [], "items": { "type": "string" } }, "acceptsBooking": { "title": "Only dentists with online booking", "type": "boolean", "description": "When true, return only dentists that offer online appointment booking.", "default": false }, "startUrls": { "title": "Direct URLs", "type": "array", "description": "Direct DentalPlans dentist profile URLs or search URLs with ?zip=XXXXX to scrape. Profile URLs fetch full details; search URLs extract the ZIP and run a standard search.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of dentist records to return across all ZIP codes. Set to 0 for unlimited. Free plan: 5 per run.", "default": 100 }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Visit each dentist's profile page to enrich the record with office hours, accepted plans list, bio, education, and languages. One extra request per dentist, so runs with many records are slower. Charged as an extra event per enriched record.", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "DentalPlans.com is protected by Cloudflare. The actor uses Apify Unblocker (default) which solves the challenge server-side. Switch to residential if you prefer, but Unblocker is the most reliable path.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }