{ "openapi": "3.0.1", "info": { "title": "PsychologyToday.com Search and Details scraper", "description": "Scrape PsychologyToday by state, city or direct profile URL for therapists, psychiatrists, groups and treatment-rehab. Returns name, credentials, bio, address, phone, image, specialties, expertise, types of therapy, insurance carriers, license, client focus and nearby areas.", "version": "0.0", "x-build-id": "UmkJWC6W52Oh1Vw8F" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~psychologytoday-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-psychologytoday-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~psychologytoday-scraper/runs": { "post": { "operationId": "runs-sync-memo23-psychologytoday-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~psychologytoday-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-psychologytoday-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": "Listing or profile URLs", "type": "array", "description": "Examples:\n• State-wide: https://www.psychologytoday.com/us/therapists/new-york\n• State + city: https://www.psychologytoday.com/us/therapists/ny/new-york\n• Direct profile: https://www.psychologytoday.com/us/therapists/i-wang-new-york-ny/1392436", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "therapists", "psychiatrists", "groups", "treatment-rehab" ], "type": "string", "description": "Choose which type of directory to scrape from PsychologyToday.", "default": "therapists" }, "stateCodes": { "title": "US States", "uniqueItems": true, "type": "array", "description": "Pick one or more states (2-letter code). Each code is translated to PT's full state slug and used to build `/us/{category}/{slug}`. Leave empty if you supplied **Listing or profile URLs** above.", "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" ] }, "default": [ "ny" ] }, "zipCodes": { "title": "ZIP Codes", "uniqueItems": true, "type": "array", "description": "Optional 5-digit US ZIP codes. Builds `/us/{category}/{zip}` per ZIP. Combined with **U.S. States** if both are set.", "items": { "type": "string", "pattern": "^\\d{5}$" } }, "maxItems": { "title": "Maximum number of therapist profiles to scrape", "minimum": 1, "type": "integer", "description": "Stops after this many therapist profiles have been pushed to the dataset. Pagination ends automatically when the budget is reached.", "default": 1000 }, "listingOnly": { "title": "Listing-only mode (skip profile pages)", "type": "boolean", "description": "When enabled, only the fields visible on the directory listing card are scraped (name, credentials, address, short description, image, phone, profile URL) and the per-therapist profile page is NOT fetched. Uses ~90% less proxy bandwidth, but you do NOT get specialties, expertise, types of therapy, insurance carriers, license, client focus, or nearby areas. Directly-supplied profile URLs are always fetched in full regardless of this setting.", "default": false }, "detailConcurrency": { "title": "DETAIL concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many therapist profile pages to fetch in parallel. Listing pages are always fetched sequentially.", "default": 6 }, "maxRequestRetries": { "title": "Max Request Retries", "type": "integer", "description": "Per-request retry budget. The actor multiplies this internally because each retry rotates the proxy.", "default": 5 }, "enrichEmails": { "title": "Enrich with contact emails (experimental, billed per email)", "type": "boolean", "description": "If enabled, finds a contact email for each result from its own website (or by discovering it from the name). Adds contactEmail + contactWebsite columns plus a detailed emailEnrichment object. Billed per contact email found; only charged when an email is returned, never for misses.", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy used by the scraper. Apify Residential is strongly recommended — Psychology Today rate-limits aggressively by IP.", "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 } } } } } } } } } }