# Scrapier — Google API > Places from Google Maps as structured JSON, with more Google endpoints (Search, Play, Ads Transparency and others) available in the catalog today. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/google.md ## GET /google-ad-library-leads/ Google Ad Library Leads: Structured Google data: send `urls`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.lead · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://adstransparency.google.com/advertiser/AR04619580580634296321): Google Ads Transparency Center advertiser URL. Single lookup -- next_cursor always null. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - max_items (optional, integer, default 200, locked in cursor): - max_creatives_to_try (optional, integer, default 12, locked in cursor): - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/google-ad-library-leads/?urls=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR04619580580634296321" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/google/google-ad-library-leads.md ## GET /google-ads-transparency/ Google Ad Transparency: Structured Google data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.ads · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://adstransparency.google.com/advertiser/AR04619580580634296321): Google Ad Transparency advertiser URL. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/google-ads-transparency/?urls=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR04619580580634296321" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/google/google-ads-transparency.md ## GET /google-autocomplete/ Google Autocomplete: Structured Google data: send `queries`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.suggestions Parameters: - queries (required, string, example machine learning): Search term(s). Required first call. Lookup endpoint. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - use_prefix (optional, boolean, default true): Add alpha prefixes (a-z) to each query for SEO expansion. - use_suffix (optional, boolean, default true): Add alpha suffixes (a-z) to each query for SEO expansion. - language (optional, string, default English): Language name or hl code (e.g. English, en, Spanish). - country (optional, string, default United States): Country name or gl code (e.g. Bangladesh, bd, us). - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/google-autocomplete/?queries=machine+learning" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/google/google-autocomplete.md ## GET /google-maps/ Google Maps Places: Search Google Maps for places matching a keyword around a location and get names, ratings, addresses and place IDs. Cost: 1 credit per successful call · Pagination: cursor · Results: data.places Parameters: - queries (required, string, example coffee shops): Place search keyword. Required first call. 20 places per page, no duplicate place_ids across pages. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - location (optional, string, default Houston,Texas, locked in cursor): Geocode anchor for the search (city or address). - language (optional, string, default en, locked in cursor): Result language (Google hl code). - country (optional, string, default us): Ignored -- country bias is derived from the geocoded location. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - `country` is ignored: the country bias comes from the geocoded `location`. - `language` takes a Google hl code such as en. - `queries` takes one keyword per call. Example: curl "https://api.scrapier.io/api/v2/google-maps/?queries=coffee+shops&location=Houston%2CTexas" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/google/google-maps.md ## GET /google-play-reviews/ Google Play Reviews: Structured Google data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.reviews · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example com.supercell.brawlstars): App package ID or Play Store URL. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - sort_by (optional, string, default most_relevant, locked in cursor): most_relevant | newest (alias most_recent) | rating. Sent to Google Play (server-side sort). - rating (optional, string, locked in cursor): Only reviews with this star rating (1-5), filtered server-side. - lang (optional, string, default en, locked in cursor): Store/review language (hl), e.g. en, fr, pt-BR. - country (optional, string, default us, locked in cursor): Store country (gl), 2-letter code. Apps unavailable in that country return 400 not-found. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/google-play-reviews/?urls=com.supercell.brawlstars" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/google/google-play-reviews.md ## GET /google-play-scraper/ Google Play Scraper: Structured Google data: every input is optional. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.apps · Long-running (client timeout 210 s or more) Parameters: - action (optional, string, one of: scrapeAppSearch|scrapeAppUrls|scrapeSimilarApps, default scrapeAppSearch, locked in cursor): scrapeAppSearch | scrapeAppUrls | scrapeSimilarApps. - queries (optional, string, default chatgpt): Search keyword (action=scrapeAppSearch). Required first call for that mode. - urls (optional, string): App URL / package id (action=scrapeAppUrls/scrapeSimilarApps). Required first call for those modes. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - country (optional, string, default us, locked in cursor): Storefront country. - language (optional, string, default en, locked in cursor): Language. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. No parameter is marked required; send at least one input (see descriptions). Example: curl "https://api.scrapier.io/api/v2/google-play-scraper/" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/google/google-play-scraper.md ## GET /google-play-search/ Google Play App Search: Structured Google data: send `queries`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.apps Parameters: - queries (required, string, example games): App search keyword, package ID, or Play Store URL. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - country (optional, string, default us, locked in cursor): Store country. - lang (optional, string, default en, locked in cursor): Language. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/google-play-search/?queries=games" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/google/google-play-search.md ## GET /google-search/ Google Search: Structured Google data: send `queries`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.results · Long-running (client timeout 210 s or more) Parameters: - queries (required, string, example latest technology news): Search keyword (max 2048 characters). Required on every call. - page (optional, integer, default 1): Google result page to fetch (1-50, 10 results per page). Request any page directly (1, 2, 3 ...) with the same query and filters; the response's `next_page` is null when there are no more results. - countryCode (optional, string, default us): Country code (e.g. us, gb, de). - languageCode (optional, string, default en): UI language code (e.g. en, fr, de). - dateRange (optional, string, one of: hour|day|week|month|year): Only results from the last hour/day/week/month/year (empty = any time) - site (optional, string): Restrict results to one site (adds `site:`), e.g. `github.com` - includeUnfilteredResults (optional, boolean, default false): Include omitted near-duplicate results (`filter=0`) - use_fallback (optional, boolean, default true): When Google blocks a page, fall back to a real-browser rendered Google SERP - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/google-search/?queries=latest+technology+news" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/google/google-search.md ## GET /google-shopping-product-reviews/ Google Shopping Product Reviews: Structured Google data: send `products`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.reviews Parameters: - products (required, string, example 3591805395819257241): Google Shopping gid or product URL. Required on the first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - sort_by (optional, string, one of: relevance|recency, default relevance, locked in cursor): - star_rating (optional, string, one of: all|1|2|3|4|5, default all, locked in cursor): - exclude_incentivized (optional, boolean, default false, locked in cursor): - country (optional, string, default US, locked in cursor): - language (optional, string, default en, locked in cursor): - judgments (optional, boolean, default true, locked in cursor): Sentiment + issue labels. - labels (optional, string, locked in cursor): reports,incentivized,injection | all | none. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/google-shopping-product-reviews/?products=3591805395819257241" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/google/google-shopping-product-reviews.md