Datasets API endpoint
Use Crawlora's Google Maps Business Dataset Item API to search or inspect stored structured datasets as JSON. This page includes request parameters, cURL examples, response schema, validation behavior, credit cost, and a Playground link for testing before integration. Dataset endpoints read indexed records and do not apply proxy routing.
/datasets/google-map-businesses/items/{place_id}Returns one stored Google Maps business by Google place_id from dataset id enum value `google-map-businesses`. The `category` field is a Google Maps type token in lower-case snake_case (e.g. `dentist`, `bus_stop`, `atm`). A `rating` of `null` means no aggregate rating is available for that business; read it together with `review_count`. Locationless service-area businesses (online/mobile/home-based) have a `null` `geo`. Developers commonly use this endpoint for repeatable dataset search, filtering, facets, local business enrichment, analytics, exports, and internal tools that need structured records beyond the limited manual refinement available in the Google Maps app. Authentication uses the x-api-key header, usage is metered with the credit cost shown on this page, and the request does not trigger live scraping or proxy routing.
Request parameters are generated from the active endpoint catalog. Dataset parameters filter, page, facet, or locate stored structured records; they do not configure a live scraper or proxy path.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| place_id (path) | string | Yes | Google Place ID, max 256 characters | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/google-map-businesses/items/ChIJN1t_tDeuEmsRUsoyG83frY4" \ -H "x-api-key: $CRAWLORA_API_KEY"
Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.
Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.
| Plan | Price | Included credits | Daily cap | Rate limit | Overage |
|---|---|---|---|---|---|
| Free | $0/mo | 2,000 | 500 daily credits | 5/min | No overage |
| Starter | $9/mo | 20,000 | 5,000 daily credits | 15/min | $0.75/1,000 overage credits when enabled |
| Growth | $29/mo | 100,000 | 25,000 daily credits | 45/min | $0.45/1,000 overage credits when enabled |
| Pro | $79/mo | 400,000 | No daily cap | 120/min | $0.30/1,000 overage credits |
| Business | $199/mo | 1,200,000 | No daily cap | 300/min | $0.20/1,000 overage credits |
| Enterprise | $499/mo | 5,000,000 | No daily cap | 1,000/min | $0.12/1,000 overage credits |
This endpoint reads stored indexed dataset records. It does not execute a live upstream Google Maps request, browser session, or proxy-routed scraping job.
- The `category` field is a Google Maps type token in lower-case snake_case (e.g. `dentist`, `bus_stop`, `atm`), not a Title-Case display label. - A `null` `rating` means no aggregate rating is available for that business (never a literal zero-star score); a present `rating` is always between `1.0` and `5.0`. Read it together with `review_count`. - Returns `404` when the Place ID is not present in the stored dataset. - Does not trigger live scraping. Example response: ```json { "code": 200, "msg": "OK", "data": { "place_id": "ChIJ99URUeOAhYAR0J5ZUxTesDQ", "name": "Hotel Zephyr San Francisco", "address": "250 Beach St, San Francisco, CA 94133", "website": "https://www.hotelzephyrsf.com/" } } ```
Crawlora does not silently return invalid dataset search results when filters, pagination, coordinates, or stored record lookups cannot be satisfied.
| Status | Common failure case |
|---|---|
| 400 | Invalid input, missing required parameter, invalid enum, bad coordinate pair, or result window beyond the dataset limit |
| 404 | Requested stored dataset item is not present |
| 429 | Plan or endpoint rate limit exceeded |
| 500 | Internal dataset query or storage error |
When possible, Crawlora returns structured error context so your integration can adjust filters, page size, location inputs, or lookup identifiers.
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
{
"code": 200,
"msg": "OK",
"data": {
"place_id": "ChIJ99URUeOAhYAR0J5ZUxTesDQ",
"name": "Hotel Zephyr San Francisco",
"address": "250 Beach St, San Francisco, CA 94133",
"website": "https://www.hotelzephyrsf.com/"
}
}Request schema
No body schema
Response schema
#/definitions/datasets.googleMapBusinessResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | es.GoogleBusiness | No | ||||
| data.address | string | No | 250 Beach St, San Francisco, CA 94133 | |||
| data.amenities | array | No | ['Free Wi-Fi', 'Air-conditioned', 'Wi-Fi', 'Parking'] | |||
| data.category | array | No | ["hotel"] | |||
| data.city | string | No | San Francisco | |||
| data.contact | unknown | No | 🆕 Contact information | |||
| data.contact_is_updated | boolean | No | ||||
| data.country | string | No | United States | 🆕 Geographic hierarchy | ||
| data.county | string | No | San Francisco County | |||
| data.created_at | string | No | 🆕 Timestamps | |||
| data.description | string | No | A 3-minute walk from Pier 41 in the Fisherman's Wharf district... | |||
| data.geo | es.GeoPoint | No | ||||
| data.geo.lat | number | No | ||||
| data.geo.lon | number | No | ||||
| data.geo_is_updated | boolean | No | ||||
| data.id | string | No | ChIJ99URUeOAhYAR0J5ZUxTesDQ | |||
| data.image | string | No | https://lh5.googleusercontent.com/p/AF1QipP_O55x7gOwR3AaM09CVmzEUude9wMHMPwc--yp | |||
| data.locations | array | No | ['San Francisco', 'Los Angeles'] | |||
| data.name | string | No | Hotel Zephyr San Francisco | |||
| data.phone | string | No | 14156176565 | |||
| data.place_id | string | No | ChIJ99URUeOAhYAR0J5ZUxTesDQ | |||
| data.rating | number | No | 4.1 | Rating is the aggregate Google rating (1.0–5.0). It is a pointer so a business with NO aggregate Google rating serializes as `rating: null` rather than a misleading 0 — Google never assigns a 0.x average, so 0 always meant "unrated". Consumers computing an average must skip nulls; use min_rating>0 to exclude them. | ||
| data.review_count | integer | No | 3213 | |||
| data.similarweb | similarweb.SimilarWebResp | No | ||||
| data.similarweb.Category | string | No | ||||
| data.similarweb.CategoryRank | object | No | ||||
| data.similarweb.CategoryRank.Category | string | No | ||||
| data.similarweb.CategoryRank.Rank | string | No | ||||
| data.similarweb.Competitors | object | No | ||||
| data.similarweb.Competitors.TopSimilarityCompetitors | array | No | ||||
| data.similarweb.Countries | array | No | ||||
| data.similarweb.Countries[].Code | string | No | ||||
| data.similarweb.Countries[].Name | string | No | ||||
| data.similarweb.Countries[].UrlCode | string | No | ||||
| data.similarweb.CountryRank | object | No | ||||
| data.similarweb.CountryRank.Country | integer | No | ||||
| data.similarweb.CountryRank.CountryCode | string | No | ||||
| data.similarweb.CountryRank.Rank | integer | No | ||||
| data.similarweb.Description | string | No | ||||
| data.similarweb.Engagments | object | No | ||||
| data.similarweb.Engagments.BounceRate | string | No | ||||
| data.similarweb.Engagments.Month | string | No | ||||
| data.similarweb.Engagments.PagePerVisit | string | No | ||||
| data.similarweb.Engagments.TimeOnSite | string | No | ||||
| data.similarweb.Engagments.Visits | string | No | ||||
| data.similarweb.Engagments.Year | string | No | ||||
| data.similarweb.EstimatedMonthlyVisits | object | No | ||||
| data.similarweb.EstimatedMonthlyVisits.2024-09-01 | integer | No | ||||
| data.similarweb.EstimatedMonthlyVisits.2024-10-01 | integer | No | ||||
| data.similarweb.EstimatedMonthlyVisits.2024-11-01 | integer | No | ||||
| data.similarweb.GlobalCategoryRank | unknown | No | ||||
| data.similarweb.GlobalRank | object | No | ||||
| data.similarweb.GlobalRank.Rank | integer | No | ||||
| data.similarweb.IsDataFromGa | boolean | No | ||||
| data.similarweb.IsSmall | boolean | No | ||||
| data.similarweb.LargeScreenshot | string | No | ||||
| data.similarweb.Notification | object | No | ||||
| data.similarweb.Notification.Content | unknown | No | ||||
| data.similarweb.Policy | integer | No | ||||
| data.similarweb.SiteName | string | No | ||||
| data.similarweb.SnapshotDate | string | No | ||||
| data.similarweb.Title | string | No | ||||
| data.similarweb.TopCountryShares | array | No | ||||
| data.similarweb.TopCountryShares[].Country | integer | No | ||||
| data.similarweb.TopCountryShares[].CountryCode | string | No | ||||
| data.similarweb.TopCountryShares[].Value | number | No | ||||
| data.similarweb.TopKeywords | array | No | ||||
| data.similarweb.TopKeywords[].Cpc | number | No | ||||
| data.similarweb.TopKeywords[].EstimatedValue | number | No | ||||
| data.similarweb.TopKeywords[].Name | string | No | ||||
| data.similarweb.TopKeywords[].Volume | number | No | ||||
| data.similarweb.TrafficSources | object | No | ||||
| data.similarweb.TrafficSources.Direct | number | No | ||||
| data.similarweb.TrafficSources.Mail | number | No | ||||
| data.similarweb.TrafficSources.Paid Referrals | number | No | ||||
| data.similarweb.TrafficSources.Referrals | number | No | ||||
| data.similarweb.TrafficSources.Search | number | No | ||||
| data.similarweb.TrafficSources.Social | number | No | ||||
| data.similarweb.Version | integer | No | ||||
| data.state | string | No | California | |||
| data.town | string | No | Fisherman's Wharf | |||
| data.updated_at | string | No | ||||
| data.url | string | No | https://www.google.com/maps/place/?q=place_id:ChIJ99URUeOAhYAR0J5ZUxTesDQ | |||
| data.website | string | No | https://www.hotelzephyrsf.com/ | 🆕 Website and status | ||
| data.website_status | es.WebsiteStatus | No | ||||
| data.website_status.checked_at | string | No | ||||
| data.website_status.dns_resolvable | boolean | No | ||||
| data.website_status.error | string | No | ||||
| data.website_status.http_reachable | boolean | No | ||||
| data.website_status.status_code | integer | No | ||||
| data.website_status.url | string | No | ||||
| msg | string | No | OK |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/google-map-businesses/items/ChIJN1t_tDeuEmsRUsoyG83frY4" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.
Read Crawlora terms