Help Center for G Map Extractor

View subscription packages

The subscription page shows all available packages so you can choose the one that matches your scraping needs.

1. From the dashboard, navigate to the Subscription section in the menu.
2. Review the packages and limits shown on the subscription page.
3. Select the package that fits your volume and usage pattern.

Wallet and available credits

The wallet section gives you a clear view of how many credits you currently have across your packages. These credits are consumed when you run Google Map Scraping, Nearby, or Specific Place tools.

• Open the Wallet section from the app menu.
• See total credits left and how they are attached to your packages.
• Monitor usage before starting new scraping jobs.

Transaction history for purchased packages

You can also review every purchase for transparency and record keeping. Transaction history shows the packages you bought and how credits were added to your account.

• Go to the Transaction or History area in your wallet or billing section.
• Check the list of purchased packages, dates, and amounts.
• Use this list for your own records or invoicing.

Google MAP Scraping

Google MAP Scraping is your main extractor for pulling business data from a Google Maps search. To get a successful result you must complete all required fields in the form.

1. Open the Google MAP Scraping tool from your dashboard.
2. Fill in every required field in the form such as keyword, location, and other options.
3. Submit the form to start scraping.

After you submit, the tool processes your input and returns a result table with matching businesses.

If you miss any required field, the system shows an error instead of starting the job. This helps you fix the input before using credits.

Once all data is filled correctly and processed, you see the final result with all the extracted information for that search.

Google Nearby Map Scraper

Google Nearby Map Scraper focuses on businesses around a specific location. It is useful for hyperlocal research, store surroundings, or checking nearby competitors.

Fill in the form with the required fields, such as coordinates, address, or search radius, then run the scraper.

After entering all fields and starting the job, you get a similar result list. From this result you can easily download the file in XLSX format.

Specific Place Information

Specific Place Information is designed for deeper details about a single business or place. You enter the required inputs for that place and the tool returns a structured summary and full result.

After you put in all the info, you first see a summary of the data that will be returned.

When processing finishes and all data is complete, the final result appears with the detailed information for that place.

Specific Place Review

Specific Place Review collects reviews for a particular business. You must fill out all the required fields in this section to see review results.

After you provide the info, you first see a summary of the review data that will be collected.

When you fill out all data and the job finishes, the final result view shows the full review information for that place.

Specific Place Photos

Specific Place Photos retrieves photos related to a business. It is useful if you want to visually review how a place looks or prepare assets for reports and presentations.

Fill all fields in the form so the tool can identify the correct place.

After putting in all the info, the tool shows a summary of photo data that will be returned.

When you click the button to fetch photos, you get a result similar to the image gallery that appears on the business page you searched for.

Specific What is Here

Specific What is Here gives you detailed information about what is located at a chosen point on the map. That can include business details if a listing exists for that location.

To use it, fill out all fields in the form based on the coordinates or area you want to check.

After entering all info, you see a summary of the specific information the tool is about to retrieve for that point or business.

When you click the button to run the job, the result shows a view similar to the business page or map information for that location.

Overview

The G Map Extractor API lets you automate Google Maps scraping from your own apps, internal tools, and workflows. Use it to trigger extractions, check job status, and download structured data without logging into the dashboard every time.

This section gives you a high-level overview of authentication, base URL, example requests, and common response formats. Update endpoint URLs and parameters here to match your live API implementation.

Authentication

All API requests must be authenticated with an API key. You can generate and manage keys from your account inside the G Map Extractor app (for example under an API Keys or Developer section).

• Keep your API key secret and never share it publicly.
• Send the key using an Authorization header.
• Use separate keys for production and testing if possible.

Authorization: Bearer YOUR_API_KEY_HERE

Base URL

All endpoints are organized under a single base URL. Replace this with your live API domain if it is different.

Base URL:
https://api.gmapextractor.io/

In most cases you will send HTTPS requests to routes that start with /v1/ or another version prefix.

Example: start a Google MAP scraping job

This example shows how to start a standard Google Maps business search via the API. The API runs the extraction in the background and returns a job_id that you can use to track progress.

POST /v1/maps/search

Request body example (JSON):

{
  "query": "dentists in Chicago",
  "location": "Chicago, IL, USA",
  "radius_km": 10,
  "country_code": "US",
  "language": "en",
  "max_results": 250
}

cURL example:

curl -X POST "https://api.gmapextractor.io/v1/maps/search" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "dentists in Chicago",
    "location": "Chicago, IL, USA",
    "radius_km": 10,
    "country_code": "US",
    "language": "en",
    "max_results": 250
  }'

Typical response (simplified):

{
  "job_id": "job_123456789",
  "status": "queued",
  "estimated_rows": 240,
  "credits_used": 240
}

Check job status

After starting a job, use the job_id to check its current status. When the job is complete you can fetch the results or download the file.

GET /v1/jobs/{job_id}

Example:

curl "https://api.gmapextractor.io/v1/jobs/job_123456789" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Sample response:

{
  "job_id": "job_123456789",
  "type": "maps_search",
  "status": "completed",
  "created_at": "2025-01-06T10:30:00Z",
  "finished_at": "2025-01-06T10:31:12Z",
  "total_rows": 247,
  "download_url": "https://api.gmapextractor.io/v1/jobs/job_123456789/download"
}

Download results

When a job shows status: completed, you can download the data directly using a download link or a dedicated download endpoint. The file format is usually XLSX or CSV depending on your settings.

GET /v1/jobs/{job_id}/download

Example:

curl -L "https://api.gmapextractor.io/v1/jobs/job_123456789/download" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -o "dentists-chicago.xlsx"

The downloaded file can be opened in Excel, Google Sheets, or imported into CRMs and other platforms just like files you download from the dashboard.

Error handling

When something goes wrong, the API returns an HTTP error code together with a JSON response that explains what happened. Handle these cases in your integration so you can retry or fix the request.

Common error patterns:

Example error response:

{
  "error": {
    "code": 400,
    "type": "invalid_request",
    "message": "The 'query' field is required."
  }
}

Best practices

• Use test queries first to confirm your integration before running large extractions.
• Respect rate limits and avoid sending many jobs in tight loops.
• Log job_id values so you can re-check or re-download data later.
• Rotate and protect API keys, especially in team environments.
• Align your usage with Google’s terms and local regulations in your region.

Google MAP Scraping files list

Every time you run a Google MAP Scraping job, the result is stored in a scraped files list. This history makes it easy to revisit old jobs and download data again without rerunning the scrape.

• Open the Scraped Files or history section inside the Google MAP Scraping area.
• See the list of completed jobs with their names and dates.
• Click download to get the file again when you need it.

Nearby Map scraped files history

Nearby Map Scraper also keeps its own history of scraped files. This is useful when you run different radius or location tests and want to compare results later.

• Open the Nearby scraper section and go to its Scraped Files or history tab.
• Review the list of past Nearby jobs and their statuses.
• Download the XLSX files directly from this history without running the same search again.

Download formats

Most tools let you download results in XLSX format so you can open them in Excel or any spreadsheet software. This format is ideal for sorting, filtering, and importing into CRMs or other tools.

• Click the download button next to a completed job.
• Save the XLSX file to your computer.
• Open it in your preferred app to continue working with the data.