{ "openapi": "3.0.1", "info": { "title": "DealerRater Scraper - Car Dealer Reviews & Leads", "description": "Scrape DealerRater car dealerships by state, make, city or URL: name, phone, website, full address, star rating, review count, review samples, salespeople and a 0-100 lead score.", "version": "0.1", "x-build-id": "aUx5OLvOLLK6cwSCa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~dealerrater-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-dealerrater-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/scrapesage~dealerrater-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-dealerrater-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/scrapesage~dealerrater-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-dealerrater-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": { "states": { "title": "States", "type": "array", "description": "US states to scrape dealerships from. Combine with Makes to narrow (state + make). Leave empty if you only paste URLs below.", "items": { "type": "string", "enum": [ "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" ] } }, "makes": { "title": "Vehicle makes", "type": "array", "description": "Vehicle brands to scrape (e.g. Toyota, Honda, Ford, BMW, Tesla). Each State is crossed with each Make. Leave empty to scan ALL major makes in the chosen states (slower; dealers are deduplicated).", "items": { "type": "string" } }, "city": { "title": "City filter (optional)", "type": "string", "description": "Only keep dealerships in this city (e.g. \"Austin\"). Dealers are listed state-wide, so increase Max pages per search when filtering by city." }, "searchUrls": { "title": "DealerRater URLs (advanced)", "type": "array", "description": "Paste DealerRater dealer pages (/dealer/...-review-ID/), salesperson pages (/sales/...-review-ID/) or directory pages (/directory/State/Make/). These run in addition to the States/Makes above. Salesperson URLs produce standalone salesperson lead records.", "items": { "type": "string" } }, "minRating": { "title": "Min star rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Keep only dealerships with an overall rating at or above this value (0-5)." }, "minReviewCount": { "title": "Min review count", "minimum": 0, "type": "integer", "description": "Keep only dealerships with at least this many reviews." }, "maxReviewsPerDealer": { "title": "Review samples per dealer", "minimum": 0, "maximum": 30, "type": "integer", "description": "How many recent review samples to embed in each dealer record (title, rating, date, author, snippet). Comes from the same page — no extra cost.", "default": 10 }, "enrichEmails": { "title": "Enrich with dealer-website emails", "type": "boolean", "description": "For dealers that publish their own website, crawl it (home + contact/about, max 3 pages) for contact emails, phones and socials. Billed per email-enrichment event, only when emails are found.", "default": false }, "maxItems": { "title": "Max records", "minimum": 1, "type": "integer", "description": "Maximum number of records (dealers + salespeople) to return.", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Safety cap on directory result pages (≈30 dealers each) to page through per state+make search.", "default": 10 }, "monitorMode": { "title": "Monitor mode (only new / changed)", "type": "boolean", "description": "Remember records seen in previous runs (in a named key-value store) and output only those that are NEW or whose rating / review count / website / staff changed. Each record gets a monitorStatus of \"new\" or \"updated\". Works independently of Apify Schedules — schedule the actor to build a fresh-data feed.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Name of the key-value store that holds monitor-mode state. Use a distinct name per saved search to keep histories separate.", "default": "dealerrater-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 16, "type": "integer", "description": "Concurrent page fetches. DealerRater serves clean HTML quickly; 6-10 is a good balance.", "default": 8 }, "maxAttemptsPerPage": { "title": "Max attempts per page", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many fresh proxy sessions to try before giving up on a page (handles transient proxy errors).", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. A US RESIDENTIAL proxy is recommended for reliable results — keep the default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }