# MapQuest Place & POI API Scraper (`rl1987/mapquest-api-scraper`) Actor Search MapQuest for places / points of interest by keyword + location and extract the full place record (address, geo, categories, phone, website, ratings, reviews, hours, photos, amenities and more) straight from MapQuest's own private mobile GraphQL API. - **URL**: https://apify.com/rl1987/mapquest-api-scraper.md - **Developed by:** [R.L.](https://apify.com/rl1987) (community) - **Categories:** Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 place / poi record (shallow)s This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## MapQuest Scraper πŸ“ β€” Scrape MapQuest Places, POIs, Addresses, Ratings, Hours, Phones & Photos **MapQuest Scraper** β€” Search MapQuest for places / points of interest by keyword + location and extract the full place record (address, geo, categories, phone, website, ratings, reviews, hours, photos, amenities and more) straight from MapQuest's own private mobile GraphQL API. It reads MapQuest's own API directly, so it's **fast, reliable and complete** β€” no flaky HTML parsing, no headless browser. Export to **JSON, CSV, Excel, or an API**. > Search any city, ZIP or address for restaurants, cafes, hotels, gas stations and any business β€” with full address, geo, categories, phone, website, ratings, reviews, hours and photos. --- ### ✨ Why use this MapQuest Scraper? - 🟒 **No code required** β€” type a search term and a location, click **Start**, download your data. - ⚑ **Straight from MapQuest's own mobile API** β€” structured JSON, not scraped HTML or a headless browser. - 🧾 **Maximum field coverage** β€” address, geo, categories, phone, website, price level, ratings (Yelp/Tripadvisor), reviews, weekly hours, all photos, amenities, and more. - 🌍 **Human-friendly inputs** β€” a plain location string ("San Francisco", "Paris, France", a ZIP or an address) resolved via MapQuest's own place lookup. - πŸ”Ž **Optional full detail** β€” flip on `includeDetails` to enrich every result with reviews, weekly hours, amenities, description and photos. - πŸ’Έ **Transparent pay-per-result pricing** β€” pay only for the places you get. --- ### 🎯 What can you do with MapQuest data? - **Local business & POI datasets** β€” build a directory of places for any area. - **Lead generation** β€” collect names, phones, websites and addresses of businesses by category and city. - **Location intelligence** β€” map ratings, categories and opening hours across a region. - **Competitive research** β€” analyse nearby businesses, ratings and reviews at scale. --- ### πŸ“₯ What data does the MapQuest Scraper extract? Each row includes: `id`, `name`, `type`, `category`, `categories`, `address`, `street`, `locality`, `region`, `postcode`, `country`, `county`, `latitude`, `longitude` …and more. See the full **Data table** below. --- ### πŸš€ How to scrape MapQuest (3 steps) 1. **Set your input** β€” provide `q` or `location` (see the table below; defaults work out of the box). 2. **Pick options** β€” filters, a `proxyConfiguration`, and a `maxItems` cap. 3. **Run & export** β€” click **Start**, then download the dataset as JSON/CSV/Excel or fetch it via the API. --- ### βš™οΈ Input | Field | Type | Default | Description | | --- | --- | --- | --- | | `q` | string | `coffee` | What to search for near the location, e.g. "coffee", "pizza", "gas station", "hotels", or a business name. | | `location` | string | `San Francisco` | A human-friendly place to search around: a city, neighborhood, ZIP or address, e.g. "San Francisco", "Paris, France", "10001". Resolved to coordinates via MapQuest's own place lookup. | | `latitude` | string | – | Optional: search around this exact latitude instead of resolving the Location string. | | `longitude` | string | – | Optional: search around this exact longitude instead of resolving the Location string. | | `includeDetails` | boolean | `true` | For every result, fetch the full place detail (reviews, weekly hours, amenities, all photos, description, taxonomy, weather). Slower but richer. | | `maxItems` | integer | `20` | Maximum number of places to return (the search returns up to ~96 per query). 0 = as many as the API returns. | | `proxyConfiguration` | object | Apify Proxy | Route requests through a proxy (Apify Proxy by default). | #### Example input ```jsonc { "q": "coffee", "location": "San Francisco", "includeDetails": true, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ```` *** ### πŸ“€ Output Each result is a JSON object like this: ```jsonc { "id": "288458664", "name": "Oasis at Gold Spike", "type": "Hotel", "category": "Hotels", "categories": [ "Hotels" ], "address": "217 Las Vegas Blvd, Las Vegas, NV 89101, US", "street": "217 Las Vegas Blvd", "locality": "Las Vegas", "region": "NV", "postcode": "89101", "country": "US", "county": null, "latitude": 36.17103, "longitude": -115.13989, "phone": "+17025516807", "website": "https://www.oasisatgoldspike.com/", "url": "https://www.mapquest.com/us/nevada/oasis-at-gold-spike-288458664", "price": "MODERATE", "rating": 3, "rating_provider": "YELP", "rating_url": "https://www.yelp.com/biz/oasis-at-gold-spike-las-vegas-2?adjust_creative=mapquest&utm_campaign=yelp_feed&utm_medium=feed_v2&utm_source=mapquest", "reviews_total": 833, "reviews": [ { "body": "Easy check-in, the pool and room was clean. Close to Fremont (around the corner from nacho daddy) and the nightclub looks like a big adult arcade. Good price…", "date": "2026-06-06", "rating": 8, "author": { "…": "2 fields" } }, { "body": "Good stay very helpful Miguel say the front desk would come again and wonderful price for the room", "date": "2026-05-24", "rating": 10, "author": { "…": "2 fields" } }, "…+3 more" ], "photos_total": 56, "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/dGBesIb-gXejNbnJ1dtWfg/l.jpg", "photos": [ { "url": "https://s3-media0.fl.yelpcdn.com/bphoto/dGBesIb-gXejNbnJ1dtWfg/l.jpg", "caption": "View of Oasis at Gold Spike from Las Vegas Boulevard", "primary": true }, { "url": "https://s3-media0.fl.yelpcdn.com/bphoto/wy6Awmy7-RYfr3QNs_gKlA/l.jpg", "caption": null }, "…+54 more" ], "hours_open": true, "hours_timezone": "America/Los_Angeles", "hours_today": "07:00:00Z-07:00:00Z", "hours": [ { "start": "07:00:00Z", "end": "07:00:00Z", "dayOfWeek": 0 }, { "start": "07:00:00Z", "end": "07:00:00Z", "dayOfWeek": 1 }, "…+5 more" ], "amenities": { "hasWiFi": true, "isPetFriendly": false }, "description": "Oasis at Gold Spike is a boutique hotel in downtown Las Vegas, featuring mid-century modern guest rooms and unique accommodations like the Sugar Shack tiny h…", "breadcrumbs": [ { "name": "United States", "url": "https://www.mapquest.com/us/united-states-282934758" }, { "name": "Nevada", "url": "https://www.mapquest.com/us/nevada/nevada-282095573" }, "…+3 more" ], "tips": null, "tagline": null, "payment_details": { "accepted": [ "CREDIT" ] }, "taxonomy": null, "providers": [ { "id": "101", "name": "foursquare", "attribution": "Partial Data by Foursquare." }, { "id": "1001", "name": "infogroup", "attribution": "Partial Data by Infogroup Β© 2026. All rights reserved." } ], "weather": null, "fuel_prices": null, "booking_website": "https://www.priceline.com/hotels?refid=PLHBC9842OPQ", "is_closed": false, "distance": 110 } ``` > Fields marked *(detail)* β€” `reviews`, `hours`, `amenities`, `description`, `photos`, `taxonomy`, `providers`, `fuel_prices`, `weather` β€” are only populated when the per-item detail option is enabled. *** ### 🧾 Data table | Field | Type | Description | | --- | --- | --- | | `id` | text | MapQuest ID | | `name` | text | Name | | `type` | text | Type | | `category` | text | Primary category | | `categories` | array | Categories | | `address` | text | Address | | `street` | text | Street | | `locality` | text | City | | `region` | text | Region | | `postcode` | text | Postcode | | `country` | text | Country | | `county` | text | County | | `latitude` | number | Latitude | | `longitude` | number | Longitude | | `phone` | text | Phone | | `website` | link | Website | | `url` | link | MapQuest URL | | `price` | text | Price level | | `rating` | number | Rating | | `rating_provider` | text | Rating provider | | `rating_url` | link | Rating URL | | `reviews_total` | number | Reviews count | | `reviews` | array | Reviews *(detail)* | | `photos_total` | number | Photos count | | `photo_url` | link | Primary photo | | `photos` | array | Photos *(detail)* | | `hours_open` | boolean | Open now | | `hours_timezone` | text | Time zone | | `hours_today` | text | Hours today | | `hours` | array | Weekly hours *(detail)* | | `amenities` | object | Amenities *(detail)* | | `description` | text | Description *(detail)* | | `breadcrumbs` | array | Breadcrumbs | | `tips` | array | Tips | | `tagline` | object | Tagline | | `payment_details` | object | Payment details | | `taxonomy` | object | Taxonomy *(detail)* | | `providers` | array | Providers *(detail)* | | `weather` | object | Weather *(detail)* | | `fuel_prices` | array | Fuel prices *(detail)* | | `booking_website` | text | Booking URL | | `is_closed` | boolean | Permanently closed | | `distance` | number | Distance from center | *** ### πŸ’° Pricing β€” pay per result This actor uses **pay-per-event** pricing: you pay only for the rows it delivers. | You scrape | Price | | --- | --- | | **Place / POI record** (shallow, search result) | **$1.50 per 1,000 rows** | | **Place detail lookup** (extra, when `includeDetails` is on) | **+$1.50 per 1,000 rows** | *** ### πŸ”Œ Use the MapQuest Scraper via API Run it programmatically with the [Apify API](https://docs.apify.com/api/v2): ```bash curl -X POST "https://api.apify.com/v2/acts/mapquest-api-scraper/runs?token=YOUR_TOKEN" \ -H 'Content-Type: application/json' \ -d '{ "q": "coffee", "location": "San Francisco", "includeDetails": true, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' ``` Or with the Apify CLI: `apify call mapquest-api-scraper -i input.json -o`. *** ### ❓ FAQ **What do I need to provide?** A search query (e.g. "coffee", "pizza", "hotels", or a business name) and a location (a city, neighborhood, ZIP or address). The location is resolved to coordinates automatically via MapQuest's own place lookup β€” you can also pass an exact latitude/longitude instead. **How many results can I get per search?** MapQuest's search returns a ranked set of up to ~96 places per query. Use `maxItems` to cap how many you want. **Does it need a MapQuest account or API key?** No. The scraper uses MapQuest's public mobile endpoint with guest access β€” no account, key or login required. **What extra data does `includeDetails` add?** Full reviews (author, text, rating, date), the complete weekly opening hours, amenities, a long description, all photos, taxonomy, providers and (for gas stations) fuel prices. *** ### πŸ› οΈ How it works The actor impersonates MapQuest's official app/site and calls its private API the same way the app does, then normalises each response into the flat record above. No browser, no HTML scraping β€” just clean, structured data. *** ### πŸ“Œ Good to know - Scrape only public place / POI data and respect MapQuest's Terms of Service and robots policy. - For personal data, comply with GDPR/CCPA and applicable law β€” you are the data controller. - Fields can be `null` when MapQuest doesn't expose them for a given record. *** ### ⭐ Found this useful? Give the **MapQuest Scraper** a star on Apify and check out my other `apify-*-api-scraper` actors. # Actor input Schema ## `q` (type: `string`): What to search for near the location, e.g. "coffee", "pizza", "gas station", "hotels", or a business name. ## `location` (type: `string`): A human-friendly place to search around: a city, neighborhood, ZIP or address, e.g. "San Francisco", "Paris, France", "10001". Resolved to coordinates via MapQuest's own place lookup. ## `latitude` (type: `string`): Optional: search around this exact latitude instead of resolving the Location string. ## `longitude` (type: `string`): Optional: search around this exact longitude instead of resolving the Location string. ## `includeDetails` (type: `boolean`): For every result, fetch the full place detail (reviews, weekly hours, amenities, all photos, description, taxonomy, weather). Slower but richer. ## `maxItems` (type: `integer`): Maximum number of places to return (the search returns up to ~96 per query). 0 = as many as the API returns. ## `proxyConfiguration` (type: `object`): Route requests through a proxy (Apify Proxy by default). ## Actor input object example ```json { "q": "coffee", "location": "San Francisco", "includeDetails": true, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "q": "coffee", "location": "San Francisco", "latitude": "", "longitude": "", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("rl1987/mapquest-api-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 = { "q": "coffee", "location": "San Francisco", "latitude": "", "longitude": "", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("rl1987/mapquest-api-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 '{ "q": "coffee", "location": "San Francisco", "latitude": "", "longitude": "", "proxyConfiguration": { "useApifyProxy": true } }' | apify call rl1987/mapquest-api-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rl1987/mapquest-api-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "MapQuest Place & POI API Scraper", "description": "Search MapQuest for places / points of interest by keyword + location and extract the full place record (address, geo, categories, phone, website, ratings, reviews, hours, photos, amenities and more) straight from MapQuest's own private mobile GraphQL API.", "version": "0.0", "x-build-id": "t7nNr73VYybNVnrxE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rl1987~mapquest-api-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rl1987-mapquest-api-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/rl1987~mapquest-api-scraper/runs": { "post": { "operationId": "runs-sync-rl1987-mapquest-api-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/rl1987~mapquest-api-scraper/run-sync": { "post": { "operationId": "run-sync-rl1987-mapquest-api-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": { "q": { "title": "Search query", "type": "string", "description": "What to search for near the location, e.g. \"coffee\", \"pizza\", \"gas station\", \"hotels\", or a business name." }, "location": { "title": "Location", "type": "string", "description": "A human-friendly place to search around: a city, neighborhood, ZIP or address, e.g. \"San Francisco\", \"Paris, France\", \"10001\". Resolved to coordinates via MapQuest's own place lookup." }, "latitude": { "title": "Latitude (advanced)", "type": "string", "description": "Optional: search around this exact latitude instead of resolving the Location string." }, "longitude": { "title": "Longitude (advanced)", "type": "string", "description": "Optional: search around this exact longitude instead of resolving the Location string." }, "includeDetails": { "title": "Fetch full place details", "type": "boolean", "description": "For every result, fetch the full place detail (reviews, weekly hours, amenities, all photos, description, taxonomy, weather). Slower but richer.", "default": true }, "maxItems": { "title": "Max items", "type": "integer", "description": "Maximum number of places to return (the search returns up to ~96 per query). 0 = as many as the API returns.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Route requests through a proxy (Apify Proxy by default).", "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 } } } } } } } } } } ```