Fetch search engine results
Retrieves structured search results from Google, Bing, Yandex, or DuckDuckGo based on the provided search engine URL. This endpoint allows direct passing of search engine URLs rather than building complex query parameters.
query Parameters
urlstring · uri · requiredThe complete search engine URL to scrape results from. Must be from one of the supported search engines: Google, Bing, Yandex, or DuckDuckGo.
Google Search Parameters
Search Types
- Images:
tbm=isch(e.g., https://www.google.com/search?q=hamburger&tbm=isch) - Shopping:
tbm=shop(e.g., https://www.google.com/search?q=hamburger&tbm=shop) - News:
tbm=nws(e.g., https://www.google.com/search?q=hamburger&tbm=nws) - Videos:
tbm=vid(e.g., https://www.google.com/search?q=hamburger&tbm=vid) - Jobs:
ibp=htl;jobs(e.g., https://www.google.com/search?q=hamburger&ibp=htl%3Bjobs)
Localization
- Country:
gl=<country-code>(e.g., gl=us) - Language:
hl=<language-code>(e.g., hl=en)
Pagination
- Start:
start=<number>(e.g., start=10) - Results per page:
num=<number>(e.g., num=50)
Geolocation
- Location:
uule=<encoded-location>(e.g., uule=w+CAIQICINVW5pdGVkK1N0YXRlcw)
Google Maps
The API supports direct scraping of Google Maps search results (e.g., https://www.google.com/maps/search/hotels+new+york)
Example: https://www.google.com/search?q=hamburger- Images:
mobilebooleanWhen set to true, results will be fetched as if from a mobile device. This affects the layout, content, and structure of the returned data.
Example: trueDefault: false
Responses
Successful response with SERP data
organicobject[]Organic search results
adsobject[]Advertisement results (if any)
imagesobject[]Image results (if tbm=isch was used)
videosobject[]Video results (if tbm=vid was used)
shoppingobject[]Shopping results (if tbm=shop was used)
newsobject[]News results (if tbm=nws was used)
placesobject[]Map/places results (for Google Maps searches)
knowledge_panelKnowledge panel info (if available)
answer_boxFeatured snippet/answer box (if available)
related_searchesstring[]Related search queries
paginationPagination information