{
  "openapi": "3.0.1",
  "info": {
    "title": "Bookimed.com Medical Tourism Scraper — Clinics & Prices",
    "description": "Scrape medical tourism clinics and hospitals from Bookimed.com across 50+ countries and 13 languages. Extract treatment prices, star ratings, verified patient reviews, doctor rosters, success rates and certifications by country, city and procedure. Export to JSON, CSV, Excel or API.",
    "version": "1.2",
    "x-build-id": "9qYJiVRlGuurefgDW"
  },
  "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 across all searches. Set 0 for unlimited collection.",
            "default": 100
          },
          "maxLoadMore": {
            "title": "Max 'Load more' clicks per listing",
            "minimum": 0,
            "type": "integer",
            "description": "How many times to expand each listing page (each click loads ~5–10 more clinics). Set 0 for automatic/unlimited expansion governed by Max clinics.",
            "default": 0
          },
          "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}