{ "openapi": "3.0.1", "info": { "title": "Caloo Japan Hospital & Clinic Scraper", "description": "Scrape hospitals, clinics and dental clinics from Caloo (caloo.jp), Japan's hospital review directory, by prefecture, city and department. Get phone, address, GPS, rating, reviews, hours, closed days, departments, specialists, treatments, payment methods and websites. No browser, no login.", "version": "0.0", "x-build-id": "s4lrK5XuPTM0hp3an" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piquno~caloo-japan-hospital-clinic-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piquno-caloo-japan-hospital-clinic-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/piquno~caloo-japan-hospital-clinic-scraper/runs": { "post": { "operationId": "runs-sync-piquno-caloo-japan-hospital-clinic-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/piquno~caloo-japan-hospital-clinic-scraper/run-sync": { "post": { "operationId": "run-sync-piquno-caloo-japan-hospital-clinic-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": { "prefecture": { "title": "Prefecture", "enum": [ "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47" ], "type": "string", "description": "Prefecture to crawl. The whole prefecture is covered city by city when it holds more than 2,000 facilities.", "default": "13" }, "city": { "title": "City / ward filter", "type": "string", "description": "Optional. City, ward or town inside the prefecture, by Japanese name (partial matches are fine: 新宿, 千代田区, 横浜市中区, 八王子) or by JIS code (13104). Several may match a short name. Leave empty for the whole prefecture." }, "department": { "title": "Department filter", "type": "string", "description": "Optional. Medical department by Japanese or English name (内科, 歯科, 皮膚科, 小児科, Dermatology…) or caloo code (k1). The README lists all 51. Leave empty for every facility." }, "sortBy": { "title": "Sort order", "enum": [ "recommended", "rating", "reviews", "newest" ], "type": "string", "description": "Order of the search results. Matters when Max facilities is smaller than the number of facilities in the area.", "default": "recommended" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional. Your own caloo.jp search URLs, e.g. https://caloo.jp/hospitals/search/13104/all (Shinjuku), https://caloo.jp/hospitals/search/27/k91 (pediatrics in Osaka), a station page such as https://caloo.jp/hospitals/search/s1130203/all or a feature page such as https://caloo.jp/hospitals/search/13/all/64 (female doctors). Each is paginated automatically. Overrides the fields above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max facilities", "minimum": 1, "type": "integer", "description": "Stop after this many unique facilities. Each facility is one dataset item and one billable result.", "default": 100 }, "includeDetails": { "title": "Scrape facility pages", "type": "boolean", "description": "Also open every facility page for phone number, postal code, full address, GPS coordinates, kana name, access directions, closed days, payment methods, parking, director, grouped departments, specialists, specialty clinics, treatments, vaccinations, the facility's own description and the reviews shown on the page. One extra request per facility, same price per result.", "default": false }, "includeReviews": { "title": "Scrape all reviews", "type": "boolean", "description": "Also open the reviews page of every facility that has reviews or survey cards, and attach up to Max reviews of each. One or two extra requests per facility, same price per result.", "default": false }, "maxReviews": { "title": "Max reviews per facility", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on reviews and on survey cards attached to one facility when Scrape all reviews is on.", "default": 50 }, "requestDelaySecs": { "title": "Delay between requests (s)", "minimum": 0, "maximum": 30, "type": "number", "description": "Pause after each successful request.", "default": 0.5 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel requests.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is the default. Switch to residential (country JP) only if the log reports many blocked requests.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }