# Jameda Reviews Scraper (`thescrappa/jameda-reviews-scraper`) Actor Extract public Jameda doctor reviews for reputation monitoring, medical provider benchmarking, local SEO research, and patient sentiment workflows. - **URL**: https://apify.com/thescrappa/jameda-reviews-scraper.md - **Developed by:** [Scrappa](https://apify.com/thescrappa) (community) - **Categories:** Marketing, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.25 / 1,000 jameda review results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Jameda Reviews Scraper Extract public Jameda doctor reviews through Scrappa. Use this Jameda reviews scraper for reputation monitoring, medical provider benchmarking, local SEO research, patient sentiment extraction, and review intelligence workflows. ### Features - Scrape Jameda doctor reviews from one doctor URL or a batch of doctor URLs - Accept full `https://www.jameda.de/...` URLs, host-style URLs, or path-only inputs - Fetch a selected review page for every doctor URL, with sort, rating, and page-size filters - Save one Apify dataset item per review with doctor URL context - Keep `OUTPUT` compact with request counts, saved review count, and failures ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `doctor_urls` | array | Yes, unless using `doctor_url` | Recommended input. Process multiple Jameda doctor profile URLs in one Apify run. | | `doctor_url` | string | Yes, unless using `doctor_urls` | Legacy single Jameda doctor profile URL or path. | | `page` | integer | No | One-based review page for each doctor URL, 1-500. Default `1`. | | `sort` | string | No | `newest`, `oldest`, `highest`, or `lowest`. Default `newest`. | | `rating` | string | No | Filter by rating from 1 to 5. Use comma-separated values such as `4,5`. | | `per_page` | integer | No | Reviews to request per doctor URL, 1-100. Default `20`. | ### Example Input ```json { "doctor_urls": [ "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "/markus-lietzau-msc/zahnarzt/berlin" ], "page": 1, "sort": "newest", "rating": "4,5", "per_page": 20 } ```` ### Output Each Jameda review is saved as one dataset item: ```json { "review_id": "4986285", "review_text": "Sehr freundlicher und kompetenter Zahnarzt!", "rating": "4", "rating_number": 4, "date": "2025-07-15T17:38:48+02:00", "date_formatted": "15. Juli 2025", "verification_badge": "Termin verifiziert", "doctor_name": "Markus Lietzau M.Sc.", "doctor_specializations": "Zahnarzt", "doctor_overall_rating": "4,5", "doctor_overall_rating_number": 4.5, "input_doctor_url": "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "normalized_doctor_url": "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "request_page": 1, "request_sort": "newest", "request_rating": "4,5", "request_per_page": 20, "total_reviews": 132, "total_pages": 7, "has_next_page": true, "response_source": "jameda_ajax_api" } ``` The `OUTPUT` record includes the requested doctor URLs, reviews saved, failed requests, and status message. Review rows are written to the dataset as the primary output channel. ### Notes Put multiple doctor URLs in `doctor_urls` when monitoring a provider group or competitor set. This shares Apify run overhead across many review results while Scrappa handles the actual Jameda scraping work. The actor requests one selected review page per doctor URL. Use the `page`, `per_page`, `sort`, and `rating` inputs to page through larger review histories; dataset rows include `total_pages` and `has_next_page` when Jameda returns pagination metadata. For high-volume direct API access, use Scrappa at https://scrappa.co. # Actor input Schema ## `doctor_urls` (type: `array`): Recommended. Process many Jameda doctor profile URLs in one Apify run. Each saved review is one dataset item. ## `doctor_url` (type: `string`): Backward-compatible single Jameda doctor profile URL or path. Prefer Doctor URLs for normal usage, especially when monitoring reviews for more than one provider. ## `page` (type: `integer`): One-based reviews page to fetch for each doctor URL. ## `sort` (type: `string`): Sort order applied to available reviews. ## `rating` (type: `string`): Optional rating filter. Use a single value from 1 to 5 or comma-separated values such as 4,5. ## `per_page` (type: `integer`): Number of reviews to request per doctor URL. ## Actor input object example ```json { "doctor_urls": [ "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "/markus-lietzau-msc/zahnarzt/berlin" ], "doctor_url": "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "page": 1, "sort": "newest", "rating": "4,5", "per_page": 20 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "doctor_urls": [ "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "/markus-lietzau-msc/zahnarzt/berlin" ], "doctor_url": "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "rating": "4,5" }; // Run the Actor and wait for it to finish const run = await client.actor("thescrappa/jameda-reviews-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "doctor_urls": [ "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "/markus-lietzau-msc/zahnarzt/berlin", ], "doctor_url": "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "rating": "4,5", } # Run the Actor and wait for it to finish run = client.actor("thescrappa/jameda-reviews-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "doctor_urls": [ "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "/markus-lietzau-msc/zahnarzt/berlin" ], "doctor_url": "https://www.jameda.de/markus-lietzau-msc/zahnarzt/berlin", "rating": "4,5" }' | apify call thescrappa/jameda-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=thescrappa/jameda-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jameda Reviews Scraper", "description": "Extract public Jameda doctor reviews for reputation monitoring, medical provider benchmarking, local SEO research, and patient sentiment workflows.", "version": "1.0", "x-build-id": "HNywoPaNN4h2kYxFz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thescrappa~jameda-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thescrappa-jameda-reviews-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/thescrappa~jameda-reviews-scraper/runs": { "post": { "operationId": "runs-sync-thescrappa-jameda-reviews-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/thescrappa~jameda-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-thescrappa-jameda-reviews-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": { "doctor_urls": { "title": "Doctor URLs", "maxItems": 100, "type": "array", "description": "Recommended. Process many Jameda doctor profile URLs in one Apify run. Each saved review is one dataset item.", "items": { "type": "string", "minLength": 3, "maxLength": 700 } }, "doctor_url": { "title": "Legacy Doctor URL", "minLength": 3, "maxLength": 700, "type": "string", "description": "Backward-compatible single Jameda doctor profile URL or path. Prefer Doctor URLs for normal usage, especially when monitoring reviews for more than one provider." }, "page": { "title": "Page", "minimum": 1, "maximum": 500, "type": "integer", "description": "One-based reviews page to fetch for each doctor URL.", "default": 1 }, "sort": { "title": "Sort", "enum": [ "newest", "oldest", "highest", "lowest" ], "type": "string", "description": "Sort order applied to available reviews.", "default": "newest" }, "rating": { "title": "Rating Filter", "type": "string", "description": "Optional rating filter. Use a single value from 1 to 5 or comma-separated values such as 4,5." }, "per_page": { "title": "Reviews Per Page", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of reviews to request per doctor URL.", "default": 20 } } }, "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 } } } } } } } } } } ```