Local Search
The google_maps
source is designed to retrieve Google Local search results. It scrapes various location-based data, such as restaurants, hotels, coffee shops, gas stations, grocery stores, and more.
Request samples
In this example, we make a request to retrieve the first 3
pages of hotel availability for 1
guest between 2023-10-01
and 2023-10-10
for hotels in Paris
from google.com
.sons.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "google_maps",
"domain": "com",
"pages": 3,
"query": "hotels in Paris",
"context": [
{
"key": "hotel_occupancy",
"value": 1
},
{
"key": "hotel_dates",
"value": "2023-10-01,2023-10-10"
}
]
}'
We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.
Request parameter values
Generic
Basic setup and customization options for scrpaing Google local search results.
source
Sets the scraper.
google_maps
query
UTF-encoded keyword.
-
render
-
callback_url
-
user_agent_type
desktop
- mandatory parameter
Localization
Adapt search results to specific geographical locations, domains, and languages.
geo_location
-
domain
com
locale
-
context
:
results_language
-
Pagination
Controls for managing the pagination and retrieval of search results.
start_page
Starting page number.
1
pages
Number of pages to retrieve.
1
limit
Number of results to retrieve in each page.
10
Other
Additional advanced settings and controls for specialized requirements.
context
:
nfpr
true
will turn off spelling auto-correction
false
context
:
hotel_occupancy
Number of guests. NB: this parameter is only applicable if you are searching for a hotel-related search term.
-
context
:
hotel_dates
Length for staying in the hotel, from - to. Example: 2023-07-12,2023-07-13
NB: this parameter is only applicable if you are searching for a hotel-related search term.
Context parameters
All context parameters should be added to the context
array as objects with key
and value
pairs, e.g.:
...
"context": [
{
"key": "filter",
"value": "0"
}
]
...
Output example
{
"results": [
{
"content":"<!doctype html>\n<html lang=\"en\">\n<head>
...
</script></body>\n</html>\n",
"created_at": "2024-02-13 11:44:28",
"updated_at": "2024-02-13 11:45:06",
"page": 3,
"url": "https://www.google.com/search?tbm=lcl&q=hotels+in+Paris&hotel_occupancy=1&hotel_dates=2023-10-01,2023-10-10&start=40&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
"job_id": "7163135836748268545",
"status_code": 200
}
]
}
Last updated
Was this helpful?