## Getting Started ----------- ### Quick Guide #### Step 1: Choose Your Plan Visit our [Pricing Page](https://rapidapi.com/scrappa-co-scrappa-co-default/api/unlimited-google-maps/pricing) and select a plan that fits your needs: We offer the plan perfect for getting started • FREE BASIC PLAN:
• 500 free monthly requests
• No credit card required
• Hard rate limit applies #### Step 2: Make Your First API Call 1. Navigate to the **RapidAPI Playground** 2. Select any endpoint in the ***Endpoints*** section in your left panel. 3. Click the **"Test Endpoint"** the top left to send your first request. 4. View the JSON response in the right panel ✅ Success! You've made your first API call. #### Step 3: Integrate Into Your Project 1. Navigate to the **Code Snippets** tab on your right panel 2. Select your preferred programming language and HTTP Client 3. Copy the generated code snippet 4. Paste it into your project Need assistance integrating our API into your project? Please contact me using the details below. - Email: [hello@marin.sh](hello@marin.sh) - Telegram: [https://t.me/themarin](https://t.me/themarin) ## Authentication ----------- To authenticate your API requests, include these two headers: - `X-RapidAPI-Host`: Set to "unlimited-google-translate1.p.rapidapi.com" - `X-RapidAPI-Key`: Use your personal RapidAPI App API Key ## Endpoints ----------- `GET /api/maps/autocomplete` Get place/address, business and query predictions for text-based geographic queries.

Parameter	Type	Required	Description
query	String	Yes	Place name or keywords to search

`GET /api/maps/business` Get the details of the business profile

Parameter	Type	Required	Description
business_id	string	Yes	The specific ID of business profile

`GET /api/maps/review` Get the specific review of the specific business profile

Parameter	Type	Required	Description
review_id	String	Yes	The specific ID of the review
business_id	String	Yes	The specific ID of the business profile

`GET /api/maps` Search for the specific place

Parameter	Type	Required	Description
query	String	Yes	Place name or keywords to search

`GET /api/maps/advance-search` Search for the specific place with its specific coordinates and zoom level

Parameter	Type	Required	Description
lon	Number	No	Longitude of the center coordinate point of the area to search in.
Lat	Number	No	Latitude of the center coordinate point of the area to search in.
Zoom	Number	No	Zoom level for search area (3-21). Higher values = smaller search area. Based on 1000x1000 viewport with lat/lng center.
Query	String	Yes	Place name or keywords to search

`GET /api/maps/reviews` Get the reviews of the specific business profile

Parameter	Type	Required	Description
business_id	string	Yes	The specific ID of business profile
search	string	No	Search for specific words in reviews
sort	enum	No	Sort order of reviews (1 for Most Relevant, 2 for Newest, 3 for Highest Rating, 4 for Lowest Rating)
page	string	No	Page number for paginated results

## Example API Response ----------- **Successful** API Response ``` { { "id": 307000, "name": "Mall of Berlin", "price_level": null, "price_level_text": null, "review_count": 54439, "rating": 4.4, "website": "https://www.mallofberlin.de/", "domain": "mallofberlin.de", "latitude": "52.51052460", "longitude": "13.38110470", "business_id": "0x47a851cecff94831:0x9f39bce1f6ad5524", "subtypes": "[\"Shopping mall\"]", "district": "Mitte", "full_address": "Leipziger Pl. 12, 10117 Berlin, Germany", "timezone": "Europe/Berlin", "short_description": "Spacious shopping mall with a food court", "full_description": "Expansive mall offering about 300 shops, including international brands, plus a food court.", "owner_id": "106592125823300438397", "owner_name": "Mall of Berlin (Owner)", "owner_link": "https://maps.google.com/maps/contrib/106592125823300438397", "order_link": null, "google_mid": "/g/1pwgtggmf", "type": "Einkaufszentrum", "phone_numbers": "[\"+49 30 20621770\"]", "place_id": "ChIJMUj5z85RqEcRJFWt9uG8OZ8", "photos_sample": "[{\"type\": \"photo\", \"latitude\": 52.509712699999994, \"photo_id\": \"AF1QipMQZtzxdqy9p9AXdH2qiimJ43-k4ikoAyoaGFIg\", \"longitude\": 13.3796299, \"photo_url\": \"https://lh3.googleusercontent.com/p/AF1QipMQZtzxdqy9p9AXdH2qiimJ43-k4ikoAyoaGFIg=w114-h86-k-no\", \"photo_url_large\": \"https://lh5.googleusercontent.com/p/AF1QipMQZtzxdqy9p9AXdH2qiimJ43-k4ikoAyoaGFIg?w3024-h3024-k-no\", \"video_thumbnail_url\": null}]", "opening_hours": "[{\"day\": \"Wednesday\", \"date\": \"2025-09-03\", \"hours\": [\"10 AM–8 PM\"], \"special_day\": null}, {\"day\": \"Thursday\", \"date\": \"2025-09-04\", \"hours\": [\"10 AM–8 PM\"], \"special_day\": null}, {\"day\": \"Friday\", \"date\": \"2025-09-05\", \"hours\": [\"10 AM–8 PM\"], \"special_day\": null}, {\"day\": \"Saturday\", \"date\": \"2025-09-06\", \"hours\": [\"10 AM–8 PM\"], \"special_day\": null}, {\"day\": \"Sunday\", \"date\": \"2025-09-07\", \"hours\": [\"1–7 PM\"], \"special_day\": null}, {\"day\": \"Monday\", \"date\": \"2025-09-08\", \"hours\": [\"10 AM–8 PM\"], \"special_day\": null}, {\"day\": \"Tuesday\", \"date\": \"2025-09-09\", \"hours\": [\"10 AM–8 PM\"], \"special_day\": null}]", "current_status": "Closed ⋅ Opens 10 AM", "neighborhood": "Mitte", "street_address_alt": "Leipziger Pl. 12", "street_address_full": "Leipziger Pl. 12", "city": "Berlin", "zip_code": "10117", "state": null, "country_code": "DE", "attributes": "{\"parking\": {\"Paid parking lot\": true, \"Paid parking garage\": true}, \"children\": {\"Playground\": true, \"Has changing table(s)\": true}, \"payments\": {\"Debit cards\": true, \"Credit cards\": true, \"NFC mobile payments\": true}, \"amenities\": {\"Wi-Fi\": null, \"Restroom\": true}, \"offerings\": {\"Arcade games\": true}, \"accessibility\": {\"Wheelchair accessible entrance\": true, \"Wheelchair accessible restroom\": true, \"Wheelchair accessible parking lot\": true}, \"service_options\": {\"Onsite services\": true, \"In-store shopping\": true}}", "created_at": "2025-08-17T02:26:49.000000Z", "updated_at": "2025-09-03T06:49:52.000000Z" } ``` **Error** API Response ``` { "message": "Invalid API key." } ``` ⚠️ **Note:** RapidAPI gateway may return errors with different structures. Check our Error Handling / Error Response Structure section for guidance. 📋 **Response Headers:** RapidAPI automatically adds headers to responses. View the complete list at [https://docs.rapidapi.com/docs/response-headers](https://docs.rapidapi.com/docs/response-headers) ## Error Handling ----------- The Unlimited Google Maps API uses standard HTTP status codes to communicate the success or failure of your requests. When errors occur, we provide clear error messages and actionable guidance to help you resolve issues quickly. **HTTP Status Codes Reference** - **200 OK**: Request processed successfully. Your data is in the response body. - **400 Bad Request**: Your request contains invalid or missing parameters.

**Common causes:**
• Required parameters are missing
• Parameter values are incorrectly formatted
• Invalid data types (e.g., string instead of number)

**Note:** Refer to the “**message**” field, explaining the specific error. - **401 Unauthorized**: Authentication failed or API key is missing.

**Common causes:**
• Required parameters are missing
• Parameter values are incorrectly formatted
• Invalid data types (e.g., string instead of number)

**What to do?**
• Ensure your API key is included in the request headers
• Verify your API key is active.
• Check that headers are properly formatted - **403 Forbidden**: You don't have permission to access this resource..

**Common causes:**
• No active subscription to the API
• Subscription expired or suspended
• API key doesn't match the subscribed plan

**What to do?**
• Verify your subscription status in RapidAPI
• Upgrade or renew your subscription if needed.
• Contact RapidAPI support at [support@rapidapi.com](support@rapidapi.com) if you believe this is an error. - **404 Not Found**: The requested endpoint doesn't exist.

**Common causes:**
• Typo in the API endpoint URL
• Using an outdated API version
• Incorrect base URL

**What to do?**
• Double-check the endpoint URL against the documentation
• Ensure you're using the correct base URL.
• Verify the API version in your request - **429 Too Many Requests**: The limit has been exceeded

**Common causes:**
• Current rate limit is temporarily exhausted
• New requests will be blocked until the limit resets

**What to do?**
• **Wait:** Rate limits reset automatically (usually hourly)
• **Upgrade:** Consider a higher-tier plan for increased limits
• **Optimize:** Implement request caching to reduce API calls
• **Contact us:** If you believe the rate limiting is incorrect - **5XX Server Error (500, 502, and 503):** Something went wrong on our servers

**What to do?**
• **Retry:** Wait a moment and try your request again
• **Contact support:** If the problem persists, Please contact us. ## Contact Us ----------- If you're unable to resolve an issue or interested in custom plans, enterprise solutions, or high-tier subscriptions? Contact me and I'll get back to you shortly. - Email: [hello@marin.sh](hello@marin.sh) - Telegram: [https://t.me/themarin](https://t.me/themarin) ## Popular Scrappa Web API

- **[Unlimited Google Translate API](https://rapidapi.com/scrappa-co-scrappa-co-default/api/unlimited-google-translate1)** - Our Google Translate API provides seamless access to professional translation services with the same language coverage and accuracy as Google Translate. Perfect for developers seeking reliable, scalable, and cost-effective translation solutions. - **[Unlimited YouTube API](https://rapidapi.com/scrappa-co-scrappa-co-default/api/unlimited-youtube-api)** - Access YouTube's vast content library without the complexity of official API keys or quotas. Get unlimited access to videos, channels, playlists, comments, and analytics data with fast, reliable responses. - **[Google Search](https://rapidapi.com/scrappa-co-scrappa-co-default/api/unlimited-google-search1)** - The Google Search API delivers affordable, high-performance search integration with generous query limits and competitive pricing. Custom plans tailored to your requirements, plus location-based search capabilities available upon request. - **[Domain IP History](https://rapidapi.com/scrappa-co-scrappa-co-default/api/domain-ip-history)** - The Domain IP History Lookup API provides comprehensive historical IP address data for any domain. Easily integrate this API to access valuable insights about a domain's hosting infrastructure changes over time. - **[Mail Finder](https://rapidapi.com/scrappa-co-scrappa-co-default/api/mail-finder1)** - Use this fast and simple API to find verified company email addresses as found on the web. Perfect for lead generation, email campaigns, business prospecting, and building targeted contact lists for marketing outreach.