{ "openapi": "3.0.1", "info": { "title": "Bookimed.com Medical Tourism Scraper", "description": "Bookimed scraper & API: find clinics and hospitals for medical treatments and export clinic name, country, treatments, prices, rating and reviews, accreditation and profile. Medical-tourism market data and healthcare lead generation — fast, no login.", "version": "1.0", "x-build-id": "214uy2ro9HT3Wv05E" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/haketa~bookimed-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-haketa-bookimed-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/haketa~bookimed-scraper/runs": { "post": { "operationId": "runs-sync-haketa-bookimed-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/haketa~bookimed-scraper/run-sync": { "post": { "operationId": "run-sync-haketa-bookimed-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": { "countries": { "title": "Destination countries", "type": "array", "description": "Pick one or more medical tourism destinations. Leave empty to get a ready mixed sample of the most popular destinations.", "items": { "type": "string", "enum": [ "turkey", "thailand", "india", "germany", "spain", "mexico", "republic-of-korea", "united-arab-emirates", "czech-republic", "poland", "hungary", "united-states", "united-kingdom", "israel", "egypt", "georgia", "greece", "italy", "france", "switzerland", "austria", "belgium", "portugal", "romania", "bulgaria", "croatia", "cyprus", "northern-cyprus", "slovakia", "lithuania", "latvia", "ukraine", "belarus", "azerbaijan", "albania", "republic-of-kosovo", "china", "vietnam", "indonesia", "brazil", "colombia", "ecuador", "costa-rica", "dominican-republic", "canada" ], "enumTitles": [ "Turkey", "Thailand", "India", "Germany", "Spain", "Mexico", "South Korea", "United Arab Emirates", "Czech Republic", "Poland", "Hungary", "United States", "United Kingdom", "Israel", "Egypt", "Georgia", "Greece", "Italy", "France", "Switzerland", "Austria", "Belgium", "Portugal", "Romania", "Bulgaria", "Croatia", "Cyprus", "Northern Cyprus", "Slovakia", "Lithuania", "Latvia", "Ukraine", "Belarus", "Azerbaijan", "Albania", "Kosovo", "China", "Vietnam", "Indonesia", "Brazil", "Colombia", "Ecuador", "Costa Rica", "Dominican Republic", "Canada" ] }, "default": [] }, "procedures": { "title": "Procedures / treatments (optional)", "type": "array", "description": "Narrow results to specific treatments. Leave empty to include every procedure available in the selected countries.", "items": { "type": "string", "enum": [ "hair-transplant", "dental-implant", "rhinoplasty-nose-job", "breast-augmentation", "mammoplasty", "liposuction", "abdominoplasty", "brazilian-butt-lift", "installation-of-a-veneer", "knee-replacement", "hip-replacement", "coronary-artery-bypass-grafting", "kidney-transplant", "treatment-with-stem-cells", "sex-reassignment-surgery" ], "enumTitles": [ "Hair transplant", "Dental implant", "Rhinoplasty (nose job)", "Breast augmentation", "Breast surgery (mammoplasty)", "Liposuction", "Abdominoplasty (tummy tuck)", "Brazilian butt lift", "Dental veneers", "Knee replacement", "Hip replacement", "Coronary artery bypass (CABG)", "Kidney transplant", "Stem cell therapy", "Gender reassignment surgery" ] }, "default": [] }, "cities": { "title": "Cities (optional)", "type": "array", "description": "Focus on specific cities inside the chosen countries. Leave empty to search the entire country.", "items": { "type": "string", "enum": [ "istanbul", "antalya", "izmir", "ankara", "bangkok", "phuket", "mumbai", "delhi", "chennai", "berlin", "munich", "barcelona", "madrid", "cancun", "tijuana", "budapest", "prague", "warsaw" ], "enumTitles": [ "Istanbul (Turkey)", "Antalya (Turkey)", "Izmir (Turkey)", "Ankara (Turkey)", "Bangkok (Thailand)", "Phuket (Thailand)", "Mumbai (India)", "Delhi (India)", "Chennai (India)", "Berlin (Germany)", "Munich (Germany)", "Barcelona (Spain)", "Madrid (Spain)", "Cancun (Mexico)", "Tijuana (Mexico)", "Budapest (Hungary)", "Prague (Czech Republic)", "Warsaw (Poland)" ] }, "default": [] }, "citiesCustom": { "title": "Other cities (advanced, optional)", "type": "array", "description": "Power users: add extra city names not in the dropdown above (for example 'adana' or 'goa'). Combined with the cities picked above.", "default": [], "items": { "type": "string" } }, "language": { "title": "Site language / region", "enum": [ "us-uk", "de", "ru", "es", "fr", "it", "pt", "ar", "ja", "tr", "pl", "ro", "hu" ], "type": "string", "description": "Language and regional version of Bookimed content to read.", "default": "us-uk" }, "scrapeDetails": { "title": "Scrape full clinic profiles", "type": "boolean", "description": "Open each clinic profile for rich data: full description, all doctors, patient reviews, success rates, patient origins and complete treatment list. Slower but much more complete.", "default": false }, "maxClinics": { "title": "Max clinics", "minimum": 0, "type": "integer", "description": "Maximum total clinics to collect. Set 0 for unlimited.", "default": 0 }, "maxLoadMore": { "title": "Max 'Load more' clicks per listing", "minimum": 0, "type": "integer", "description": "How many times to expand each listing page (each click loads about 5 more clinics). Set 0 for unlimited.", "default": 10 }, "startUrls": { "title": "Start URLs (advanced, optional)", "type": "array", "description": "Power users: paste direct Bookimed listing or clinic-profile URLs. When provided, these are scraped in addition to the selections above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings used to load Bookimed pages reliably. The default works out of the box.", "default": { "useApifyProxy": true } }, "requestDelay": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 30000, "type": "integer", "description": "Pause between page loads in milliseconds. Higher values are gentler on the source site.", "default": 1500 } } }, "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 } } } } } } } } } }