Complete API reference

// overview

Public endpoints

All APIs accept GET query parameters and return JSON. Send the anonymous key generated on the homepage as an Authorization: Bearer header. The homepage issues one free visitor key per browser.

GET

Google Search API

https://api.litescrape.com/api/google/search

Run Google Search and independently parse organic results and an optional Knowledge Graph panel.

GET

Google AI Overview API

https://api.litescrape.com/api/google/ai-overview

Return Google’s generated Search overview, or 404 without consuming a call when none is available.

GET

Google Maps API

https://api.litescrape.com/api/google/maps

Search places and resolve exact listings.

GET

Google Reviews API

https://api.litescrape.com/api/google/reviews

Fetch, sort, filter, and paginate Google Maps reviews.

GET

Google AI Mode API

https://api.litescrape.com/api/google/ai-mode

Return Google’s own generated AI Mode answer with the sources it cited.

GET

Google Shopping API

https://api.litescrape.com/api/google/shopping

Search products with prices, sellers, ratings, and Google’s own refinements.

GET

Google Shopping Product API

https://api.litescrape.com/api/google/shopping/product

Open one product from a Shopping result: every merchant offer, its specifications, reviews, and related products.

GET

Google Contributor Reviews API

https://api.litescrape.com/api/google/contributor-reviews

Fetch up to 200 reviews from one Google Maps contributor profile. Results use contributor, search_information, and reviews.

GET

Bing Search API

https://api.litescrape.com/api/bing/search

Parse Bing SERP groups, primary and repeated knowledge cards, and pagination.

GET

Bing Maps API

https://api.litescrape.com/api/bing/maps

Search Bing Maps listings or resolve one native Bing Maps entity ID. Results use local_results or place_results.

GET

DuckDuckGo Search API

https://api.litescrape.com/api/duckduckgo/search

Search DuckDuckGo with region, safety, date, and pagination controls. Results use organic_results.

GET

DuckDuckGo Maps API

https://api.litescrape.com/api/duckduckgo/maps

Search DuckDuckGo Maps within a map viewport. Results use local_results.

GET

Yelp Search API

https://api.litescrape.com/api/yelp/search

Search Yelp by location, category, map area, sort, and pagination. Results use organic_results.

GET

Yelp Reviews API

https://api.litescrape.com/api/yelp/reviews

Fetch Yelp reviews with language, rating, sort, and pagination controls. Results use reviews.

GET

Tripadvisor Search API

https://api.litescrape.com/api/tripadvisor/search

Search Tripadvisor by text, location, coordinates, and place type. Results use search_results.

GET

Tripadvisor Place API

https://api.litescrape.com/api/tripadvisor/place

Resolve one Tripadvisor place. Results use place_results.

GET

Tripadvisor Reviews API

https://api.litescrape.com/api/tripadvisor/reviews

Fetch Tripadvisor reviews. Results use reviews.

GET

Apple Maps Places API

https://api.litescrape.com/api/apple/maps/places

Resolve up to 50 Apple Maps places by MUID with source-provided details.

GET

Apple Maps Reviews API

https://api.litescrape.com/api/apple/maps/reviews

Return ratings and written reviews attributed to Apple. Results use rating_summary, ratings, and reviews.

GET

Google Maps Live Foot Traffic API

https://api.litescrape.com/api/google/maps/popular-times

Fetch an uncached current-versus-usual busyness reading for one Google Place ID.

GET

Google Maps Posts API

https://api.litescrape.com/api/google/maps/posts

Fetch posts for one Maps feature ID.

GET

Google Maps Photo Metadata API

https://api.litescrape.com/api/google/maps/photo-meta

Resolve contributor, place, coordinates, type, and photo date.

GET

Google Play Apps APIAlpha

https://api.litescrape.com/api/google/play/apps

Search and browse Android apps, categories, device storefronts, and charts.

GET

Google Play Games APIAlpha

https://api.litescrape.com/api/google/play/games

Browse games, categories, device storefronts, and charts, or query the shared Android app search.

GET

Google Play Books APIAlpha

https://api.litescrape.com/api/google/play/books

Search and browse ebooks, audiobooks, series, categories, and charts.

GET

Google Play Movies APIAlpha

https://api.litescrape.com/api/google/play/movies

Search and browse movies, TV shows, episodes, categories, and charts.

GET

Google Play Product APIAlpha

https://api.litescrape.com/api/google/play/product

Read app, ebook, audiobook, movie, or TV product details.

GET

Google Play Reviews APIAlpha

https://api.litescrape.com/api/google/play/reviews

Filter and paginate product reviews, including available developer replies.

GET

Apple App Store Search APIAlpha

https://api.litescrape.com/api/apple/app-store/search

Search iPhone, iPad, and Mac apps or developers by storefront.

GET

Apple App Store Product APIAlpha

https://api.litescrape.com/api/apple/app-store/product

Read app details, version history, screenshots, ratings, privacy disclosures, and related apps.

GET

Apple App Store Reviews APIAlpha

https://api.litescrape.com/api/apple/app-store/reviews

Read storefront-specific app reviews. iOS pages contain up to 25 reviews; Mac pages contain up to 10 and use Apple’s newest-first ordering.

GET

Google Ads APIAlpha

https://api.litescrape.com/api/google/ads

Return paid search ads, local ads, shopping ads, and the rest of the Google results page.

GET

Google Local APIAlpha

https://api.litescrape.com/api/google/local

Search local businesses and target local CIDs.

// api key status

Check your balance and concurrency

GET /api/keys/status returns the calls remaining on your key and its configured concurrency limit. Send your key in the Authorization: Bearer header; no query parameters or request body are required. Checking status does not consume a call and works at zero balance.

Set LITESCRAPE_API_KEY to your existing key, then run:

curl 'https://api.litescrape.com/api/keys/status' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY"

{
  "remaining_calls": 10000,
  "concurrency_limit": 25,
  "status": "active"
}

remaining_calls: calls currently available to spend.
concurrency_limit: configured simultaneous requests across endpoints sharing this key, 25 by default. Use this value to size your client concurrency; it is not a count of active requests or free slots.
status: active for a usable key.

The full response also includes pricing and credit-expiry information. Missing or malformed bearer headers return 401 missing_api_key; invalid keys return 401 invalid_api_key; disabled keys return 403 api_key_disabled.

// python quickstart

Make your first request

Install the SDK with pip install litescrape-sdk, then set LITESCRAPE_API_KEY to the live key from the homepage. The SDK reads that variable, retries transient errors, and runs at your key's concurrency limit.

Search Google

import os
from litescrape_sdk import GoogleSearch, scrape

[search] = scrape(
    [GoogleSearch(q="coffee shops in Austin", hl="en", gl="us", device="desktop")],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
results = search.raise_for_error()

for item in results.get("organic_results", []):
    print(item["position"], item["title"], item["link"])

if knowledge := results.get("knowledge_graph"):
    print(knowledge.get("title"), knowledge.get("description"))

Get a Google AI Overview

import os
from litescrape_sdk import GoogleAiOverview, scrape

[answer] = scrape(
    [GoogleAiOverview(q="what is a heat pump", hl="en", gl="us")],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
overview = answer.raise_for_error()["ai_overview"]
for block in overview.get("text_blocks", []):
    print(block.get("snippet", ""))

Find Google Ads

import os
from litescrape_sdk import GoogleAds, scrape

[page] = scrape(
    [
        GoogleAds(
            q="coffee maker",
            location="Austin, Texas, United States",
            hl="en",
            device="desktop",
        )
    ],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
payload = page.raise_for_error()

for ad in payload.get("ads", []):
    print(ad.get("position"), ad.get("title"), ad.get("link"))
for ad in payload.get("local_ads", []):
    print(ad.get("position"), ad.get("title"), ad.get("address"))
for product in payload.get("shopping_results", []):
    print(product.get("position"), product.get("title"), product.get("price"))

Search Google Local

import os
from litescrape_sdk import GoogleLocal, scrape

[search] = scrape(
    [GoogleLocal(q="coffee shops", location="Austin, Texas", hl="en", gl="us", device="desktop")],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)

for place in search.raise_for_error().get("local_results", []):
    print(place.get("title"), place.get("rating"), place.get("address"))

Search Google Shopping

import os
from litescrape_sdk import GoogleShopping, scrape

[page] = scrape(
    [
        GoogleShopping(
            q="coffee maker",
            hl="en",
            gl="us",
            min_price=50,
            max_price=100,
            sort_by=1,
        )
    ],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
for product in page.raise_for_error().get("shopping_results", []):
    print(product["position"], product["title"], product.get("price"))

Ask Google AI Mode

import os
from litescrape_sdk import GoogleAiMode, scrape

[answer] = scrape(
    [GoogleAiMode(q="what is the best espresso machine for a small kitchen", hl="en", gl="us")],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
payload = answer.raise_for_error()
for block in payload.get("text_blocks", []):
    if block["type"] == "list":
        for item in block["list"]:
            print("-", item.get("title", ""), item.get("snippet", ""))
    else:
        print(block["snippet"])
for reference in payload.get("references", []):
    print(reference["index"], reference["source"], reference["link"])

Open a Shopping product

import os
from litescrape_sdk import GoogleShopping, GoogleShoppingProduct, scrape

api_key = os.environ["LITESCRAPE_API_KEY"]

# Phase one: every shopping result carries the identifiers that open it.
[search] = scrape([GoogleShopping(q="coffee maker", hl="en", gl="us")], api_key=api_key)
first = search.raise_for_error()["shopping_results"][0]

# Phase two: open that product's own page.
[product] = scrape(
    [
        GoogleShoppingProduct(
            q="coffee maker",
            gpcid=first["gpcid"],
            headline_offer_docid=first["headline_offer_docid"],
            image_docid=first["image_docid"],
            hl="en",
            gl="us",
        )
    ],
    api_key=api_key,
)
payload = product.raise_for_error()

print(payload["product_result"]["title"])
for offer in payload.get("offers", []):
    print(offer["position"], offer["merchant"], offer.get("price"), offer.get("delivery"))

Search Bing

import os
from litescrape_sdk import BingSearch, scrape

[search] = scrape(
    [BingSearch(q="pizza shops in New York", mkt="en-US", safeSearch="moderate", device="desktop")],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
results = search.raise_for_error()

for result in results.get("organic_results", []):
    print(result["position"], result["title"], result["link"])

if knowledge := results.get("knowledge_graph"):
    print(knowledge.get("title"), knowledge.get("description"))

Search Google Maps

import os
from litescrape_sdk import GoogleMaps, scrape

[search] = scrape(
    [
        GoogleMaps(
            q="coffee shops in Austin, TX",
            type="search",
            ll="@30.2672,-97.7431,14z",
            hl="en",
            gl="us",
        )
    ],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
places = search.raise_for_error()

for place in places.get("local_results", []):
    print(place["title"], place.get("rating"))

Fetch Apple Maps places

import os
from litescrape_sdk import AppleMapsPlaces, scrape

[lookup] = scrape(
    [AppleMapsPlaces(muid="4372355869446211302", locale="en-US")],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)

for place in lookup.raise_for_error().get("place_results", []):
    print(place["title"], place.get("rating"), place.get("address"))

Fetch Apple-only ratings and reviews

import os
from litescrape_sdk import AppleMapsReviews, scrape

[page] = scrape(
    [AppleMapsReviews(muid="4560078147072908047", locale="en-GB")],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
payload = page.raise_for_error()

print(payload.get("rating_summary"))
for review in payload.get("reviews", []):
    print(review.get("rating"), review.get("description"))

Fetch place reviews

import os
from litescrape_sdk import GoogleReviews, scrape

[page] = scrape(
    [
        GoogleReviews(
            place_id="ChIJT2h1HKZZwokR0kgzEtsa03k",
            sort_by="qualityScore",
            hl="en",
            gl="us",
        )
    ],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
reviews = page.raise_for_error()

for review in reviews.get("reviews", []):
    print(review.get("rating"), review.get("snippet"))

Fetch contributor review history

import os
from litescrape_sdk import GoogleContributorReviews, scrape

[page] = scrape(
    [
        GoogleContributorReviews(
            contributor_id="109736708296406538146",
            hl="en",
            gl="us",
            limit=200,
        )
    ],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
payload = page.raise_for_error()

print(payload["contributor"].get("name"))
for review in payload.get("reviews", []):
    print(review["place_info"].get("title"), review.get("rating"), review.get("snippet"))

// mcp server

Search from any MCP client

litescrape-mcp-server gives Claude Code, Cursor, Claude Desktop, Codex, Gemini CLI, and any other MCP client live results from Google Search, Bing, DuckDuckGo, and Google Maps. No API key is needed: each network gets a free daily allowance. Add your key for Google AI Mode, AI Overview, Shopping, and Reviews, and to lift every limit.

claude mcp add litescrape -- npx -y litescrape-mcp-server

{
  "mcpServers": {
    "litescrape": {
      "command": "npx",
      "args": ["-y", "litescrape-mcp-server"]
    }
  }
}

Free allowance without a key

google_search and search: 25 calls per network per UTC day.
bing_search, duckduckgo_search, and google_maps: 50 calls each per network per UTC day.
One call at a time per network. Failed calls do not count. Limits reset at 00:00 UTC.

Add your API key

A key unlocks google_ai_mode, google_ai_overview, google_shopping, and google_reviews, removes the daily limits, and allows concurrent calls. Set LITESCRAPE_API_KEY in the server's environment:

{
  "mcpServers": {
    "litescrape": {
      "command": "npx",
      "args": ["-y", "litescrape-mcp-server"],
      "env": {
        "LITESCRAPE_API_KEY": "ls_live_..."
      }
    }
  }
}

Hosted endpoint

Clients that connect to remote servers can use https://mcp.litescrape.com/mcp instead of running the package. Send your key as Authorization: Bearer; without one, the same free allowance applies.

claude mcp add --transport http litescrape https://mcp.litescrape.com/mcp

# With your API key
claude mcp add --transport http litescrape https://mcp.litescrape.com/mcp   --header "Authorization: Bearer $LITESCRAPE_API_KEY"

Tool reference, source, and changelog: github.com/litescrape/litescrape-mcp-server. Also listed on npm, Smithery, Glama, and the official MCP registry.

// api parameters

Google Search API parameters

Litescrape can return Google SERP data, including the knowledge graph and a top-level ai_overview when Google generates one. The dedicated Google AI Overview endpoint below returns only that module when you do not need the other Search result groups.

Query and entity selectors

fast_modeOptional

Return organic results only, skipping AI Overview and all other result groups.

Type boolean Default false

Accepted valuestruefalse

Keeps search metadata and parameters. Omits cross-module position_absolute.

qConditional

Google Search query, up to 2,048 characters.

Type string

Required unless ludocid or kgmid is supplied.

ludocidConditional

Google local CID used to search for one entity.

Type decimal string

kgmidConditional

Google Knowledge Graph machine ID, such as /m/0k8z.

Type string

Geographic location

locationOptional

Human-readable city-level location encoded to UULE by Litescrape.

Type string

Conflicts with uule and lat/lon.

uuleOptional

Pre-encoded Google location value.

Type string

Conflicts with location and lat/lon.

latOptional

Latitude from -90 through 90.

Type number

Requires lon and conflicts with location and uule.

lonOptional

Longitude from -180 through 180.

Type number

Requires lat and conflicts with location and uule.

radiusOptional

Decimal search-bias radius in meters.

Type number

Requires location or lat/lon.
Desktop: 1–199; tablet/mobile: 1–1,000.

Knowledge Graph and layout controls

lsigOptional

Opaque Knowledge Graph or local-pack signature.

Type string

siOptional

Opaque cached Google search context.

Type string

ibpOptional

Google layout or expansion control.

Type string

udsOptional

Opaque Google filter token.

Type string

color_schemeOptional

Google result color presentation.

Type string

Accepted valueslightdark

Localization, filtering, and pagination

google_domainOptional

Validated Google domain, such as google.com or google.co.uk.

Type string Default google.com

glOptional

Lowercase two-letter country localization code.

Type string

hlOptional

Google interface and result language code.

Type string Default en

crOptional

One or more countryXX restrictions joined with |.

Type string

lrOptional

One or more lang_xx restrictions joined with |.

Type string

tbsOptional

Google native date or search filter string.

Type string

safeOptional

Google adult-content filtering.

Type string

Accepted valuesactiveoff

nfprOptional

Google auto-correction control.

Type string

Accepted values01

filterOptional

Google similar-result filtering control.

Type string

Accepted values01

pwsOptional

Google personalization control; 0 asks for non-personalized results.

Type string

Accepted values01

peek_pwsOptional

Google personalization peek flag, forwarded unchanged.

Type string

Accepted values01

tbmOptional

Google vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is not supported.

Type enum

startOptional

Non-negative Google result offset.

Type integer Default 0

deviceOptional

Request device profile and radius bound.

Type string Default desktop

Accepted valuesdesktoptabletmobile

Advanced query parameters

as_dtOptional

Includes or excludes as_sitesearch.

Type string

Accepted valuesie

Requires as_sitesearch.

as_epqOptional

Exact phrase query.

Type string

as_eqOptional

Excluded phrase query.

Type string

as_lqOptional

Require results that link to this URL.

Type HTTP(S) URL

as_nloOptional

Inclusive range lower bound.

Type integer string

Requires as_nhi.

as_nhiOptional

Inclusive range upper bound.

Type integer string

Requires as_nlo.

as_oqOptional

Any-of search terms.

Type string

as_qOptional

Additional all-of search terms.

Type string

as_qdrOptional

Quick range d, w, m, or y with an optional positive count.

Type string

as_rqOptional

Find pages related to this URL.

Type HTTP(S) URL

as_sitesearchOptional

Site hostname to include or exclude.

Type hostname

// api parameters

Google AI Overview API parameters

GET https://api.litescrape.com/api/google/ai-overview accepts the same complete parameter contract as Google Search, waits for Google’s bounded overview generation window, and returns search_metadata, search_parameters, and ai_overview. The overview is an object on success. When Google supplies none, the endpoint returns non-retryable 404 not_found without consuming a call.

This endpoint is additive: Google Search keeps its source-selected top-level overview. Calling both endpoints makes two independent Google requests and consumes two calls when both succeed.

Query and entity selectors

qConditional

Google Search query, up to 2,048 characters.

Type string

Required unless ludocid or kgmid is supplied.

ludocidConditional

Google local CID used to search for one entity.

Type decimal string

kgmidConditional

Google Knowledge Graph machine ID, such as /m/0k8z.

Type string

Geographic location

locationOptional

Human-readable city-level location encoded to UULE by Litescrape.

Type string

Conflicts with uule and lat/lon.

uuleOptional

Pre-encoded Google location value.

Type string

Conflicts with location and lat/lon.

latOptional

Latitude from -90 through 90.

Type number

Requires lon and conflicts with location and uule.

lonOptional

Longitude from -180 through 180.

Type number

Requires lat and conflicts with location and uule.

radiusOptional

Decimal search-bias radius in meters.

Type number

Requires location or lat/lon.
Desktop: 1–199; tablet/mobile: 1–1,000.

Knowledge Graph and layout controls

lsigOptional

Opaque Knowledge Graph or local-pack signature.

Type string

siOptional

Opaque cached Google search context.

Type string

ibpOptional

Google layout or expansion control.

Type string

udsOptional

Opaque Google filter token.

Type string

color_schemeOptional

Google result color presentation.

Type string

Accepted valueslightdark

Localization, filtering, and pagination

google_domainOptional

Validated Google domain, such as google.com or google.co.uk.

Type string Default google.com

glOptional

Lowercase two-letter country localization code.

Type string

hlOptional

Google interface and result language code.

Type string Default en

crOptional

One or more countryXX restrictions joined with |.

Type string

lrOptional

One or more lang_xx restrictions joined with |.

Type string

tbsOptional

Google native date or search filter string.

Type string

safeOptional

Google adult-content filtering.

Type string

Accepted valuesactiveoff

nfprOptional

Google auto-correction control.

Type string

Accepted values01

filterOptional

Google similar-result filtering control.

Type string

Accepted values01

pwsOptional

Google personalization control; 0 asks for non-personalized results.

Type string

Accepted values01

peek_pwsOptional

Google personalization peek flag, forwarded unchanged.

Type string

Accepted values01

tbmOptional

Google vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is not supported.

Type enum

startOptional

Non-negative Google result offset.

Type integer Default 0

deviceOptional

Request device profile and radius bound.

Type string Default desktop

Accepted valuesdesktoptabletmobile

Advanced query parameters

as_dtOptional

Includes or excludes as_sitesearch.

Type string

Accepted valuesie

Requires as_sitesearch.

as_epqOptional

Exact phrase query.

Type string

as_eqOptional

Excluded phrase query.

Type string

as_lqOptional

Require results that link to this URL.

Type HTTP(S) URL

as_nloOptional

Inclusive range lower bound.

Type integer string

Requires as_nhi.

as_nhiOptional

Inclusive range upper bound.

Type integer string

Requires as_nlo.

as_oqOptional

Any-of search terms.

Type string

as_qOptional

Additional all-of search terms.

Type string

as_qdrOptional

Quick range d, w, m, or y with an optional positive count.

Type string

as_rqOptional

Find pages related to this URL.

Type HTTP(S) URL

as_sitesearchOptional

Site hostname to include or exclude.

Type hostname

// api parameters

Google Shopping API parameters

Litescrape returns Google Shopping products, category blocks, sponsored listings, and Google’s own refinement chips. Google applies one refinement at a time, so the price range, on sale, free shipping, and small business filters are mutually exclusive; sorting combines with any one of them.

Product search

qRequired

Product query, up to 2,048 characters with no controls. Optional when a shoprs token is supplied.

Type string

shoprsOptional

Google refinement token from a previous response, up to 4,096 characters. An explicit refinement replaces the one it carries.

Type string

startOptional

Result offset from 0 through 1,000.

Type integer Default 0

numOptional

1 through 100. Responses are capped to this count and transparently consume Google’s fixed 40-product pages when needed.

Type integer

Geography and localization

locationOptional

Named search origin, up to 512 characters and 63 UTF-8 bytes once encoded. Conflicts with uule.

Type string

uuleOptional

Canonical Google location token, up to 2,048 characters. Conflicts with location.

Type string

google_domainOptional

Validated first-party Google domain.

Type string Default google.com

glOptional

Two-letter country code, normalized to lowercase.

Type string

hlOptional

Language code such as en, en-GB, or de.

Type string Default en

deviceOptional

Google returns its real layout for the selected device.

Type string Default desktop

Accepted valuesdesktoptabletmobile

// api parameters

Google AI Mode API parameters

Litescrape returns the answer Google generates on its own AI Mode surface, as ordered text blocks, together with the sources it cited. Answers are generated per request, so the same question will not return identical prose twice.

Question

qRequired

The question to ask Google AI Mode, up to 2,048 characters with no controls.

Type string

Geography

locationOptional

Named search origin, up to 512 characters and 63 UTF-8 bytes once Google-encoded. Conflicts with uule.

Type string

uuleOptional

Canonical Google location token, up to 2,048 characters. Conflicts with location.

Type string

Conversation and image

continuableOptional

Return a subsequent_request_token so this answer can be followed up.

Type boolean Default false

subsequent_request_tokenOptional

Continue a conversation from a previous continuable response. Requires a new question, and cannot be combined with image_url. Expires after 30 minutes.

Type string

image_urlOptional

Public http or https image to include in the prompt, up to 2,048 characters and 20 MB. Google Lens receives the image; the answer still comes from AI Mode.

Type string

Localization

google_domainOptional

Validated first-party Google domain the request is served from.

Type string Default google.com

glOptional

Two-letter country localization, normalized to lowercase.

Type string

hlOptional

Language code such as en, en-GB, or de.

Type string Default en

deviceOptional

Google returns its real layout for the selected device.

Type string Default desktop

Accepted valuesdesktoptabletmobile

// api parameters

Google Shopping Product API parameters

One product’s own page on Google Shopping: its merchant offers, specifications, reviews, and related products. Every product in a Google Shopping response carries the gpcid that selects it here, plus a ready-made litescrape_product_link. The grid’s search controls — shoprs, start, num, and the sort and price refinements — are not accepted: one product’s page has no page size, offset, sort order, or refinement.

Request preview: https://api.litescrape.com/api/google/shopping/product

Product selection

gpcidRequired

Product cluster ID from a shopping result, 1 to 20 decimal digits. Optional when a prds token is supplied.

Type string

Every Shopping result with a gpcid includes a ready-made litescrape_product_link.

headline_offer_docidOptional

Headline merchant offer document ID from the same shopping result, 1 to 20 decimal digits. Goes with gpcid rather than prds.

Type string

image_docidOptional

Image document ID from the same shopping result, 1 to 20 decimal digits. Goes with gpcid rather than prds.

Type string

prdsOptional

Google product selector token from a previous response, up to 2,048 characters. Conflicts with gpcid and the identifiers above.

Type string

qRequired

The search term this product was found with, up to 2,048 characters. Google resolves the product viewer against it as well as the identifiers.

Type string

Geography and localization

locationOptional

Named search origin, up to 512 characters and 63 UTF-8 bytes once encoded. Conflicts with uule.

Type string

uuleOptional

Canonical Google location token, up to 2,048 characters. Conflicts with location.

Type string

google_domainOptional

Validated first-party Google domain.

Type string Default google.com

glOptional

Two-letter country code, normalized to lowercase.

Type string

hlOptional

Language code such as en, en-GB, or de.

Type string Default en

deviceOptional

Google returns its real layout for the selected device.

Type string Default desktop

Accepted valuesdesktoptabletmobile

// api parameters

Bing Search API parameters

Litescrape can return Bing SERP data, including the knowledge graph.

Engine and query

engineOptional

Selects the Bing web-search engine.

Type string Default bing

Accepted valuesbing

qRequired

Bing search query after trimming.

Type string

Accepted length: 1 through 2,048 characters.
Control characters are rejected.
Bing query syntax such as quoted phrases and exclusions remains available.

Search origin

locationOptional

Named city-level origin used to localize the Bing request.

Type string

Maximum length: 256 characters.
Control characters are rejected.

latOptional

Latitude from -90 through 90.

Type number string

May be supplied independently or with lon.

lonOptional

Longitude from -180 through 180.

Type number string

May be supplied independently or with lat.

Localization

mktOptional

Case-insensitive Bing language-country market token.

Type string

Format: two-letter language and country, such as en-US.
Cannot be combined with cc.

ccOptional

Case-insensitive two-letter country of origin.

Type string

Format: US or GB.
Cannot be combined with mkt.

Pagination, filters, and device

firstOptional

One-based native offset for organic results.

Type integer Default 1

Range: 1 through 9,007,199,254,740,991.
Prefer litescrape_pagination.next when it is returned.

safeSearchOptional

Case-insensitive Bing adult-content policy sent as safeSearch upstream.

Type string Default moderate

Accepted valuesoffmoderatestrict

filtersOptional

Native Bing display or date filter expression.

Type string

Maximum length: 8,192 characters.
Control characters are rejected.

deviceOptional

Selects desktop, tablet, or mobile result behavior.

Type string Default desktop

Accepted valuesdesktoptabletmobile

// api parameters

Google Maps API parameters

Search Google Maps or resolve an exact place.

Collect more than 20 places

A Maps search returns up to 20 places per request. To collect more, send your first request with type=search and start=0 (or omit start). Then request the URL in pagination.next using the same Authorization: Bearer header. That URL preserves your query, location, language and filters, and advances the offset to 20, 40, and so on.

Each successful page request costs one credit. Five full pages return up to 100 places for five credits; 50 full pages return up to 1,000 for 50 credits. Deduplicate places as they arrive using place_id, falling back to data_id. Duplicate places reduce the unique count.

Stop when you have enough places, pagination.next is absent, or a page adds no new places. Google may run out of results before your target, and a next link does not guarantee a nonempty page. Successful empty or duplicate-only pages also cost one credit. Pagination continues the same search; it does not guarantee every business in a city.

Request and search query

qConditional

The business, category, address, or natural-language query to search. Required when type is search.

Type string

Examples: coffee shops in Austin, dentist near Denver

typeConditional

Chooses a result search or an exact place response. Required for query and filter searches.

Type string

Accepted valuessearchplace

Use place when sending an exact-place data sequence.

Geographic location

llOptional

A complete viewport containing latitude, longitude, and either zoom or radius.

Type string

Format: @lat,lon,14z or @lat,lon,5000m

locationOptional

A named geographic location resolved by the API. Cannot be combined with ll or lat/lon.

Type string

Requires z or m.

latOptional

Latitude for a coordinate-based viewport. Must be supplied with lon and either z or m.

Type number string

lonOptional

Longitude for a coordinate-based viewport. Must be supplied with lat and either z or m.

Type number string

zConditional

Google Maps zoom level for location or lat/lon geography.

Type number string

Accepted range: 3 through 30.
Cannot be combined with m.

mConditional

Search radius in meters for location or lat/lon geography.

Type number string

Accepted range: 1 through 15,028,132.
Cannot be combined with z.

nearbyOptional

Uses the supplied geography as a nearby-search scope.

Type boolean Default false

Requires ll, location, or a lat/lon pair.

Exact place

place_idConditional

A Google place identifier used to resolve one exact place or request live foot traffic.

Type string

Cannot be combined with data_cid or exact-place data on the primary Maps endpoint.
It is the only required parameter on /api/google/maps/popular-times.
Each live result is written under a unique internal datetime cache key and never replayed; places without published data return popular_times: null.

data_cidConditional

A decimal Google CID used to resolve one exact place.

Type string

Cannot be combined with place_id or exact-place data.

dataConditional

A Google Maps protobuf parameter sequence for search filters or an exact place.

Type string

Maximum length: 8,192 characters.
Exact-place data requires type=place.

Localization

hlOptional

Language used for Google Maps labels and returned text.

Type string Default en

Examples: en, es, fr, de

glOptional

Two-letter country code used for regional result localization.

Type string Default us

Examples: us, gb, ca, au

google_domainOptional

Validated Google domain used for the request.

Type string Default google.com

Examples: google.com, google.co.uk, google.ca

Search filters

min_priceOptional

Minimum price level for returned places.

Type integer

Must be non-negative and cannot exceed max_price.

max_priceOptional

Maximum price level for returned places.

Type integer

Must be non-negative and cannot be lower than min_price.

min_ratingOptional

Preferred minimum Google rating.

Type number

Accepted values2.02.53.03.54.04.5

Google treats this as a relevance preference.

open_stateOptional

Filters by the current open state.

Type string

Accepted valuesnow24h

Cannot be combined with open_on_day or open_at_hour.

open_on_dayOptional

Filters for places open on a specific day.

Type string

Accepted valuesmontuewedthufrisatsun

open_at_hourOptional

Filters for places open at a specific hour using 24-hour time.

Type integer

Accepted range: 0 through 23.
Requires open_on_day.

Pagination

startOptional

Native Maps result offset: 0, 20, 40, and so on. Each request returns up to 20 places and each successful request costs one credit.

Type integer Default 0

Use pagination.next when it is present instead of constructing the next request manually.

Live traffic, posts, and photos

data_idConditional

Feature identifier for the Posts endpoint or photo identifier for the photo metadata endpoint.

Type string

Posts IDs look like 0x123:0x456; follow posts_link from a Maps place response for a ready-made request.
Photo IDs contain letters, digits, underscores, or hyphens; follow a nested photo_meta_link from a Maps place response.

next_page_tokenOptional

Opaque continuation token returned by the Maps Posts endpoint.

Type string

Use only a token returned by a prior response.
Length: 16–4,096 characters.

// api parameters

Apple Maps Places API parameters

Resolve Apple Maps places by MUID.

Place identifiers and localization

muidRequired

One or more Apple Maps unique place identifiers.

Type decimal string

Separate multiple identifiers with commas.
Accepted batch size: 1 through 50 unsigned 64-bit decimal IDs.
Example: 4372355869446211302.

localeOptional

Controls Apple Maps language and regional formatting.

Type language-region locale Default en-US

Examples: en-US, fr-FR, ja-JP, and zh-TW.

// api parameters

Google Reviews API parameters

Fetch and filter Google Maps reviews for one place.

Place identifier

place_idConditional

Google place identifier for the business whose reviews should be returned.

Type string

Exactly one of place_id or data_id is required.

data_idConditional

Hexadecimal Google Maps feature identifier.

Type string

Format: 0x123:0x456
Exactly one of data_id or place_id is required.

Sorting and localization

sort_byOptional

Controls the order of returned reviews.

Type string Default qualityScore

Accepted valuesqualityScorenewestFirstratingHighratingLow

hlOptional

Language used for returned review labels and place context.

Type string Default en

glOptional

Lowercase two-letter country code used for regional localization.

Type string Default us

Review filters

queryOptional

Returns reviews matching a free-text query.

Type string

Cannot be combined with topic_id.

topic_idOptional

Returns reviews associated with a topic ID from the topics response group.

Type string

Cannot be combined with query.

numOptional

Requested number of unique reviews to return.

Type integer

Initial unfiltered requests accept 1 through 100; the default remains eight.
Counts above eight consume Google continuation pages internally and return one response.
Filtered and continuation requests accept 1 through 20.

source_metadataOptional

Includes additional review-provider icon and scale metadata when available.

Type boolean Default false

Pagination

next_page_tokenOptional

Opaque continuation token from pagination.next_page_token.

Type string

Pass the token back unchanged.
Continuation requests default to ten reviews unless num is provided.

// api parameters

DuckDuckGo Search API parameters

Search DuckDuckGo with region, safety, date, and pagination controls.

qRequired

Required search text, up to 500 characters.

Type string

klOptional

DuckDuckGo region and language token, such as us-en.

Type string

search_assistOptional

Enable DuckDuckGo query assistance; mutually exclusive with m.

Type boolean Default true

safeOptional

DuckDuckGo safe-search level.

Type string Default -1

Accepted values1-1-2

dfOptional

Date window: d, w, m, y, or YYYY-MM-DD..YYYY-MM-DD.

Type string

startOptional

Result offset from 0 through 10,000.

Type integer Default 0

mOptional

Requested result count from 1 through 50; mutually exclusive with search_assist.

Type integer Default 50

// api parameters

DuckDuckGo Maps API parameters

Search DuckDuckGo Maps within a map viewport.

qRequired

Required place or category query, up to 500 characters.

Type string

bboxConditional

Viewport rectangle as top,left,bottom,right.

Type string

latConditional

Viewport center latitude; requires lon.

Type number

lonConditional

Viewport center longitude; requires lat.

Type number

strict_bboxOptional

Exclude results outside the requested bounds.

Type boolean Default true

// api parameters

Bing Maps API parameters

Search Bing Maps listings or resolve one native Bing Maps entity ID.

qConditional

Search query; required unless place_id is supplied.

Type string

cpOptional

Optional map center in latitude~longitude form.

Type string

setlangOptional

Bing Maps interface language, such as en-US.

Type string

place_idConditional

Native Bing Maps entity identifier for a detail lookup.

Type string

firstOptional

Listing offset from 0 through 10,000.

Type integer Default 0

countOptional

Number of listings from 1 through 30.

Type integer Default 30

// api parameters

Yelp Search API parameters

Search Yelp by location, category, map area, sort, and pagination.

find_descOptional

Business name, category, or search terms.

Type string

find_locRequired

Required Yelp search location.

Type string

yelp_domainOptional

Supported localized Yelp hostname.

Type hostname Default www.yelp.com

lOptional

Optional Yelp-native map bounds token.

Type string

cfltOptional

Yelp category identifier containing letters, numbers, _ or -.

Type string

sortbyOptional

Native Yelp ordering.

Type string Default recommended

Accepted valuesrecommendedratingreview_count

attrsOptional

Yelp-native comma-separated attribute filters.

Type string

startOptional

Result offset from 0 through 10,000.

Type integer Default 0

// api parameters

Yelp Reviews API parameters

Fetch Yelp reviews with language, rating, sort, and pagination controls.

place_idRequired

Required encoded Yelp business identifier.

Type string

yelp_domainOptional

Supported localized Yelp hostname.

Type hostname Default www.yelp.com

hlOptional

Review language such as en or fr-FR.

Type string Default en

qOptional

Explicit unsupported control for review-text filtering; returns 422 when set.

Type string

sortbyOptional

Yelp review ordering.

Type string Default relevance_desc

Accepted valuesrelevance_descdate_descdate_ascrating_descrating_ascelites_desc

ratingOptional

Comma-separated ratings from 1 through 5.

Type string

not_recommendedOptional

Explicit unsupported hidden-feed control; returns 422 when true.

Type boolean Default false

startOptional

Review offset from 0 through 10,000.

Type integer Default 0

numOptional

Review count from 1 through 49.

Type integer Default 49

not_recommended_startOptional

Unavailable hidden-feed offset; rejected when supplied.

Type string

// api parameters

Tripadvisor Search API parameters

Search Tripadvisor by text, location, coordinates, and place type.

qRequired

Required search text, up to 500 characters.

Type string

tripadvisor_domainOptional

Supported localized Tripadvisor hostname.

Type hostname Default www.tripadvisor.com

localeOptional

Language or language-COUNTRY code.

Type string Default en-US

geo_idOptional

Optional positive Tripadvisor geography identifier.

Type string

latConditional

Optional search-center latitude; requires lon.

Type number

lonConditional

Optional search-center longitude; requires lat.

Type number

place_typeOptional

Result entity type.

Type string Default all

Accepted valuesallaccommodationattractionattraction_producteaterygeo

startOptional

Result offset from 0 through 10,000.

Type integer Default 0

numOptional

Result count from 1 through 30.

Type integer Default 30

// api parameters

Tripadvisor Place API parameters

Resolve one Tripadvisor place.

place_idRequired

Required positive Tripadvisor place identifier.

Type string

tripadvisor_domainOptional

Supported localized Tripadvisor hostname.

Type hostname Default www.tripadvisor.com

localeOptional

Language or language-COUNTRY code.

Type string Default en-US

currencyOptional

Three-letter ISO currency for price fields.

Type string Default USD

geo_idOptional

Optional positive parent geography identifier.

Type string

// api parameters

Tripadvisor Reviews API parameters

Fetch Tripadvisor reviews.

place_idRequired

Required positive Tripadvisor place identifier.

Type string

tripadvisor_domainOptional

Supported localized Tripadvisor hostname.

Type hostname Default www.tripadvisor.com

localeOptional

Language or language-COUNTRY code.

Type string Default en-US

startOptional

Review offset from 0 through 10,000.

Type integer Default 0

numOptional

Review count from 1 through 50.

Type integer Default 10

sort_byOptional

Chronological or machine-ranked ordering.

Type string Default recent

Accepted valuesrecentrelevance

translateOptional

Request Tripadvisor machine translation.

Type boolean Default false

// api parameters

Apple Maps Reviews API parameters

Return ratings and written reviews attributed to Apple.

muidRequired

Exactly one unsigned 64-bit decimal Apple Maps MUID.

Type decimal string

localeOptional

Apple Maps language and regional formatting.

Type language-region locale Default en-US

// api parameters

Google Contributor Reviews API parameters

Fetch up to 200 reviews from one Google Maps contributor profile.

contributor_idRequired

Required 10 to 32 digit ID from a Google Maps contributor URL.

Type decimal string

hlOptional

Review and interface language such as en, en-US, or fr.

Type language code Default en

glOptional

Two-letter country localization.

Type country code Default us

limitOptional

Review count from 1 through the anonymous source maximum of 200.

Type integer Default 200

// api parameters

Google Ads API parametersAlpha

Litescrape returns the complete Google results page, including ads, local_ads, shopping_results, organic_results, and any other result groups Google provides. Try the Google Ads API in the playground.

Request endpoint: https://api.litescrape.com/api/google/ads

Query and location

qRequired

Google Ads search query, up to 2,048 characters with no controls.

Type string

locationRequired

Human-readable location where the ad search originates, up to 63 UTF-8 bytes once Google-encoded.

Type string

Example: Austin, Texas, United States.

Language, filtering, and device

hlOptional

Google interface and result language, such as en, en-GB, or de.

Type language code Default en

safeOptional

Google adult-content filtering.

Type string

Accepted valuesactiveoff

nfprOptional

Google spelling auto-correction control. Set 1 to exclude corrected queries.

Type string

Accepted values01

deviceOptional

Google returns its real layout for the selected device.

Type string Default desktop

Accepted valuesdesktoptabletmobile

SerpAPI parameter compatibility

SerpAPI documents 13 Google Ads parameters. Litescrape accepts six directly, fixes the engine at the endpoint, moves authentication to a bearer header, and leaves five SerpAPI platform controls out of its public contract. See the SerpAPI Google Ads reference.

Six direct query parameters, two endpoint-level equivalents, and five unsupported platform controls.
SerpAPI parameter	Purpose	Litescrape support	Litescrape behavior
`q`	Search query	Yes	Required query parameter with the same name.
`location`	Named search origin	Yes	Required query parameter; Litescrape encodes it directly for Google.
`hl`	Result language	Yes	Optional query parameter; defaults to en.
`safe`	Adult-content filtering	Yes	Optional query parameter accepting active or off.
`nfpr`	Spelling auto-correction control	Yes	Optional query parameter accepting 0 or 1.
`engine`	Select the SerpAPI engine	Built in	Fixed to google_ads by the endpoint; do not send it.
`device`	Desktop, tablet, or mobile layout	Yes	Optional query parameter; defaults to desktop.
`no_cache`	Bypass the provider cache	No	No public cache override; caching is service-managed.
`async`	Submit an asynchronous job	No	Requests are synchronous and return one JSON response.
`zero_trace`	Select SerpAPI ZeroTrace mode	No	Not accepted as a Litescrape query parameter.
`api_key`	Authenticate with SerpAPI	Bearer auth	Use Authorization: Bearer <LITESCRAPE_API_KEY>; do not put keys in the URL.
`output`	Choose JSON or HTML output	No	The endpoint always returns JSON.
`json_restrictor`	Restrict fields in SerpAPI JSON	No	The endpoint returns the complete parsed response; shape it in your client.

// api parameters

Google Local API parametersAlpha

Litescrape can return Google Local results and pagination data.

Local query and entity

qRequired

Google Local query, up to 2,048 characters with no controls.

Type string

ludocidOptional

Google local CID, up to 128 digits.

Type decimal string

tbsOptional

Google compatibility token forwarded unchanged; the provider may leave ranking unchanged.

Type string

startOptional

Local-result offset through 10,000; source-exhausted offsets above 1,000 return empty.

Type integer Default 0

Local geography

locationOptional

Human-readable location, up to 512 characters.

Type string

Cannot be combined with uule.

uuleOptional

Canonical Google named-location token, up to 2,048 characters.

Type string

Cannot be combined with location.

Local result localization

google_domainOptional

Validated Google domain.

Type string Default google.com

Examples: google.com, google.co.uk, google.fr.

glOptional

Country localization normalized to lowercase.

Type two-letter country

hlOptional

Google interface and result language.

Type language code Default en

deviceOptional

Compatibility value over device-invariant Maps data.

Type string Default desktop

Accepted valuesdesktoptabletmobile

// api parameters

Google Play Apps API parameters Alpha

Search and browse Android apps, categories, device storefronts, and charts.

GET https://api.litescrape.com/api/google/play/apps

Alpha: store layouts and field availability may change. Returns organic_results, source-selected app_highlight, items_highlight, charts, and litescrape_pagination. Optional groups appear only when supplied by the store.

Use your existing bearer key. A successful response consumes one call; failures do not. Follow returned pagination links with the same parameters. Tokens are specific to this API and operation.

Retained native response bundles are linked by search_metadata.raw_file and search_metadata.prettify_file. They remain available for at least seven days (today and the previous seven UTC date buckets), require an active bearer key, and do not consume another call.

# pip install litescrape-sdk
import os
from litescrape_sdk import GooglePlayApps, scrape

[result] = scrape(
    [GooglePlayApps(
        q="coffee",
    )],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
print(result.raise_for_error())

qOptional

Optional query with 1 to 2,048 UTF-8 bytes of printable text. Excludes category. Omit it to browse the storefront.

Type string

hlOptional

Storefront language, such as en, de, or zh-TW. Maximum 32 characters.

Type string Default en

glOptional

Two-letter country code.

Type string Default us

apps_categoryOptional

Native category identifier, such as MEDICAL or GAME_PUZZLE. Excludes q and an explicit store_device.

Type string

store_deviceOptional

Omit for the default phone storefront. An explicit selection excludes q and category.

Type string Default phone

Accepted valuesphonetablettvchromebookwatchcar

ageOptional

Requires the children’s category: FAMILY for apps and movies, or coll_1689 for books.

Type string

Accepted valuesAGE_RANGE1AGE_RANGE2AGE_RANGE3

chartOptional

Chart identifier such as topselling_free, topselling_paid, or topgrossing. Excludes q and all pagination selectors. Apps and games charts require phone or an omitted store_device.

Type string

next_page_tokenOptional

Use the returned next_page_token with the same parameters. Excludes chart, section_page_token, and see_more_token.

Type string

section_page_tokenOptional

Continue one result group using its returned token and the same parameters. Excludes the other pagination selectors and chart.

Type string

see_more_tokenOptional

Open a result collection using its returned token and the same parameters. Excludes the other pagination selectors and chart.

Type string

// api parameters

Google Play Games API parameters Alpha

Browse games, categories, device storefronts, and charts, or query the shared Android app search.

GET https://api.litescrape.com/api/google/play/games

Use your existing bearer key. A successful response consumes one call; failures do not. Follow returned pagination links with the same parameters. Tokens are specific to this API and operation.

# pip install litescrape-sdk
import os
from litescrape_sdk import GooglePlayGames, scrape

[result] = scrape(
    [GooglePlayGames()],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
print(result.raise_for_error())

qOptional

Optional query with 1 to 2,048 UTF-8 bytes of printable text. Excludes category. Uses shared Android app search. Omit q or choose games_category to browse games.

Type string

hlOptional

Storefront language, such as en, de, or zh-TW. Maximum 32 characters.

Type string Default en

glOptional

Two-letter country code.

Type string Default us

games_categoryOptional

Native category identifier, such as MEDICAL or GAME_PUZZLE. Excludes q and an explicit store_device.

Type string

store_deviceOptional

Omit for the default phone storefront. An explicit selection excludes q and category.

Type string Default phone

Accepted valuesphonetablettvchromebookwatchwindows

chartOptional

Chart identifier such as topselling_free, topselling_paid, or topgrossing. Excludes q and all pagination selectors. Apps and games charts require phone or an omitted store_device.

Type string

next_page_tokenOptional

Use the returned next_page_token with the same parameters. Excludes chart, section_page_token, and see_more_token.

Type string

section_page_tokenOptional

Continue one result group using its returned token and the same parameters. Excludes the other pagination selectors and chart.

Type string

see_more_tokenOptional

Open a result collection using its returned token and the same parameters. Excludes the other pagination selectors and chart.

Type string

// api parameters

Google Play Books API parameters Alpha

Search and browse ebooks, audiobooks, series, categories, and charts.

GET https://api.litescrape.com/api/google/play/books

Alpha: store layouts and field availability may change. Returns organic_results grouped by format, charts, and litescrape_pagination. Optional groups appear only when supplied by the store.

Use your existing bearer key. A successful response consumes one call; failures do not. Follow returned pagination links with the same parameters. Tokens are specific to this API and operation.

# pip install litescrape-sdk
import os
from litescrape_sdk import GooglePlayBooks, scrape

[result] = scrape(
    [GooglePlayBooks(
        q="Dune",
    )],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
print(result.raise_for_error())

qOptional

Optional query with 1 to 2,048 UTF-8 bytes of printable text. Excludes category. Omit it to browse the storefront.

Type string

hlOptional

Storefront language, such as en, de, or zh-TW. Maximum 32 characters.

Type string Default en

glOptional

Two-letter country code.

Type string Default us

books_categoryOptional

Native category identifier, such as coll_1689 for children’s books or FAMILY for family movies. Excludes q.

Type string

ageOptional

Requires the children’s category: FAMILY for apps and movies, or coll_1689 for books.

Type string

Accepted valuesAGE_RANGE1AGE_RANGE2AGE_RANGE3

priceOptional

1 for free books or 2 for paid books. Requires q.

Type integer

Accepted values12

chartOptional

Chart identifier such as topselling_free, topselling_paid, or topgrossing. Excludes q and all pagination selectors. Apps and games charts require phone or an omitted store_device.

Type string

next_page_tokenOptional

Use the returned next_page_token with the same parameters. Excludes chart, section_page_token, and see_more_token.

Type string

section_page_tokenOptional

Continue one result group using its returned token and the same parameters. Excludes the other pagination selectors and chart.

Type string

see_more_tokenOptional

Open a result collection using its returned token and the same parameters. Excludes the other pagination selectors and chart.

Type string

// api parameters

Google Play Movies API parameters Alpha

Search and browse movies, TV shows, episodes, categories, and charts.

GET https://api.litescrape.com/api/google/play/movies

Alpha: store layouts and field availability may change. Returns organic_results grouped by format, charts, and litescrape_pagination. Optional groups appear only when supplied by the store.

Use your existing bearer key. A successful response consumes one call; failures do not. Follow returned pagination links with the same parameters. Tokens are specific to this API and operation.

# pip install litescrape-sdk
import os
from litescrape_sdk import GooglePlayMovies, scrape

[result] = scrape(
    [GooglePlayMovies(
        q="Dune",
    )],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
print(result.raise_for_error())

qOptional

Optional query with 1 to 2,048 UTF-8 bytes of printable text. Excludes category. Omit it to browse the storefront.

Type string

hlOptional

Storefront language, such as en, de, or zh-TW. Maximum 32 characters.

Type string Default en

glOptional

Two-letter country code.

Type string Default us

movies_categoryOptional

Native category identifier, such as coll_1689 for children’s books or FAMILY for family movies. Excludes q.

Type string

ageOptional

Requires the children’s category: FAMILY for apps and movies, or coll_1689 for books.

Type string

Accepted valuesAGE_RANGE1AGE_RANGE2AGE_RANGE3

chartOptional

Chart identifier such as topselling_free, topselling_paid, or topgrossing. Excludes q and all pagination selectors. Apps and games charts require phone or an omitted store_device.

Type string

next_page_tokenOptional

Use the returned next_page_token with the same parameters. Excludes chart, section_page_token, and see_more_token.

Type string

section_page_tokenOptional

Continue one result group using its returned token and the same parameters. Excludes the other pagination selectors and chart.

Type string

see_more_tokenOptional

Open a result collection using its returned token and the same parameters. Excludes the other pagination selectors and chart.

Type string

// api parameters

Google Play Product API parameters Alpha

Read app, ebook, audiobook, movie, or TV product details.

GET https://api.litescrape.com/api/google/play/product

Alpha: store layouts and field availability may change. Returns product_info, offers, media, descriptions, ratings, sample reviews, related products, and format-specific information such as authors, cast, seasons, and episodes. Optional groups appear only when supplied by the store.

Use your existing bearer key. A successful response consumes one call; failures do not. Follow returned pagination links with the same parameters. Tokens are specific to this API and operation.

# pip install litescrape-sdk
import os
from litescrape_sdk import GooglePlayProduct, scrape

[result] = scrape(
    [GooglePlayProduct(
        product_id="com.duolingo",
    )],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
print(result.raise_for_error())

product_idRequired

Native Google Play product identifier, with 1 to 512 letters, digits, underscores, dots, or hyphens.

Type string

storeOptional

Product catalog containing this identifier.

Type string Default apps

Accepted valuesappsbooksaudiobooksmoviestv

season_idOptional

Native season identifier, such as tvseason-OVPad1njPzI.P. Requires store=tv.

Type string

hlOptional

Storefront language, such as en, de, or zh-TW. Maximum 32 characters.

Type string Default en

glOptional

Two-letter country code.

Type string Default us

// api parameters

Google Play Reviews API parameters Alpha

Filter and paginate product reviews, including available developer replies.

GET https://api.litescrape.com/api/google/play/reviews

Alpha: store layouts and field availability may change. Returns reviews with identity, rating, text, likes, dates, versions, responses, and litescrape_pagination. Optional groups appear only when supplied by the store.

Use your existing bearer key. A successful response consumes one call; failures do not. Follow returned pagination links with the same parameters. Tokens are specific to this API and operation.

# pip install litescrape-sdk
import os
from litescrape_sdk import GooglePlayReviews, scrape

[result] = scrape(
    [GooglePlayReviews(
        product_id="com.duolingo",
        num=5,
    )],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
print(result.raise_for_error())

product_idRequired

Native Google Play product identifier, with 1 to 512 letters, digits, underscores, dots, or hyphens.

Type string

storeOptional

Product catalog containing this identifier.

Type string Default apps

Accepted valuesappsbooksaudiobooksmoviestv

hlOptional

Storefront language, such as en, de, or zh-TW. Maximum 32 characters.

Type string Default en

glOptional

Two-letter country code.

Type string Default us

platformOptional

Platform associated with the reviews.

Type string Default phone

Accepted valuesphonetabletwatchchromebooktv

ratingOptional

Only reviews with this rating, from 1 through 5.

Type integer

sort_byOptional

1 for relevant, 2 for newest, or 3 for rating.

Type integer Default 1

Accepted values123

numOptional

Number of reviews, from 1 through 199.

Type integer Default 40

next_page_tokenOptional

Returned review continuation. Preserve product, store, language, country, platform, rating, sort order, and count.

Type string

// api parameters

Apple App Store Search API parameters Alpha

Search iPhone, iPad, and Mac apps or developers by storefront.

GET https://api.litescrape.com/api/apple/app-store/search

Alpha: store layouts and field availability may change. Returns organic_results with prices, developers, ratings, genres, releases, languages, screenshots, and supported devices. Optional groups appear only when supplied by the store.

Use your existing bearer key. A successful response consumes one call; failures do not. Follow returned pagination links with the same parameters. Tokens are specific to this API and operation.

# pip install litescrape-sdk
import os
from litescrape_sdk import AppleAppStoreSearch, scrape

[result] = scrape(
    [AppleAppStoreSearch(
        term="coffee",
    )],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
print(result.raise_for_error())

termRequired

Required search term with 1 to 2,048 UTF-8 bytes of printable text, and at most 4,096 bytes after URL encoding.

Type string

countryOptional

Two-letter Apple storefront country. UK is accepted as an alias for GB.

Type string Default us

langOptional

Language-region code, such as en-us or fr-fr.

Type string Default en-us

numOptional

Maximum results after filtering, from 1 through 200.

Type integer Default 10

disallow_explicitOptional

Exclude explicit results when true.

Type boolean Default false

Accepted valuestruefalse

propertyOptional

Use developer to match developer names, ignoring case.

Type string

Accepted valuesdeveloper

category_idOptional

Filter results by a native genre identifier, from 1 through 2,147,483,647.

Type integer

deviceOptional

mobile for iPhone apps, tablet for iPad apps, or desktop for Mac apps.

Type string Default mobile

Accepted valuesmobiletabletdesktop

// api parameters

Apple App Store Product API parameters Alpha

Read app details, version history, screenshots, ratings, privacy disclosures, and related apps.

GET https://api.litescrape.com/api/apple/app-store/product

Alpha: store layouts and field availability may change. Returns title, id, developer, price, rating, platform screenshots, version_history, ratings_and_reviews, privacy, information, featured_in, and related apps. Optional groups appear only when supplied by the store.

Use your existing bearer key. A successful response consumes one call; failures do not. Follow returned pagination links with the same parameters. Tokens are specific to this API and operation.

# pip install litescrape-sdk
import os
from litescrape_sdk import AppleAppStoreProduct, scrape

[result] = scrape(
    [AppleAppStoreProduct(
        product_id="570060128",
    )],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
print(result.raise_for_error())

product_idRequired

Positive decimal Apple app identifier, up to 20 digits.

Type string

countryOptional

Two-letter Apple storefront country. UK is accepted as an alias for GB.

Type string Default us

typeOptional

App product type.

Type string Default app

Accepted valuesapp

// api parameters

Apple App Store Reviews API parameters Alpha

Read storefront-specific app reviews. iOS pages contain up to 25 reviews; Mac pages contain up to 10 and use Apple’s newest-first ordering.

GET https://api.litescrape.com/api/apple/app-store/reviews

Alpha: store layouts and field availability may change. Returns reviews, search_information, and litescrape_pagination; fields absent from Apple’s response are omitted. Optional groups appear only when supplied by the store.

Use your existing bearer key. A successful response consumes one call; failures do not. Follow returned pagination links with the same parameters. Tokens are specific to this API and operation.

# pip install litescrape-sdk
import os
from litescrape_sdk import AppleAppStoreReviews, scrape

[result] = scrape(
    [AppleAppStoreReviews(
        product_id="570060128",
    )],
    api_key=os.environ["LITESCRAPE_API_KEY"],
)
print(result.raise_for_error())

product_idRequired

Positive decimal Apple app identifier, up to 20 digits.

Type string

countryOptional

Two-letter Apple storefront country. UK is accepted as an alias for GB.

Type string Default us

sortOptional

mostrecent or mosthelpful. Apple’s Mac storefront always returns newest first.

Type string Default mostrecent

Accepted valuesmostrecentmosthelpful

pageOptional

One-based page number, from 1 through 2,147,483,647. Exhausted pages return an empty review list.

Type integer Default 1

// json response

Response structure

Successful responses include request metadata, normalized parameters, and the result groups available for that operation. Optional groups are omitted when the source does not provide them.

{
  "search_metadata": {
    "id": "b0aeae6949e0c6885d20be24",
    "status": "Success",
    "total_time_taken": 1.42
  },
  "search_parameters": {
    "q": "coffee shops in Austin, TX",
    "type": "search",
    "ll": "@30.2672,-97.7431,14z"
  },
  "search_information": {
    "local_results_state": "Results for exact spelling"
  },
  "local_results": [
    {
      "position": 1,
      "title": "Example Coffee",
      "rating": 4.8,
      "reviews": 312
    }
  ],
  "pagination": {
    "next": "https://..."
  }
}

{
  "search_metadata": {
    "status": "Success",
    "google_url": "https://www.google.com/search?q=Apple"
  },
  "search_parameters": {
    "q": "Apple",
    "google_domain": "google.com",
    "hl": "en",
    "device": "desktop"
  },
  "knowledge_graph": {
    "title": "Apple",
    "type": "Technology company",
    "kgmid": "/m/0k8z",
    "description": "American multinational technology company"
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Apple",
      "link": "https://www.apple.com/",
      "displayed_link": "https://www.apple.com"
    }
  ],
  "related_searches": [
    {
      "block_position": 1,
      "query": "Apple products",
      "items": [
        {
          "name": "iPhone",
          "image": "https://images.example/iphone.jpg",
          "link": "https://www.apple.com/iphone/"
        }
      ],
      "link": "https://www.google.com/search?q=Apple+products"
    }
  ]
}

{
  "search_metadata": {
    "id": "a4d234f6b74a330f8a8d5069",
    "status": "Success",
    "bing_url": "https://www.bing.com/search?q=pizza+shops+in+New+York"
  },
  "search_parameters": {
    "engine": "bing",
    "q": "pizza shops in New York",
    "mkt": "en-US",
    "device": "desktop"
  },
  "knowledge_graph": {
    "title": "Pizza",
    "description": "A baked flatbread dish with toppings."
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Example Pizza",
      "link": "https://example.com/pizza"
    }
  ],
  "pagination": {
    "next": "https://www.bing.com/search?q=pizza+shops+in+New+York&first=11"
  },
  "litescrape_pagination": {
    "next": "https://api.litescrape.com/api/bing/search?q=pizza+shops+in+New+York&first=11"
  }
}

// errors

Stable error bodies

Every JSON error includes a machine-readable code, request ID, and retry guidance. Fix 400-level request errors before retrying.

400Invalid parameter contract

401Missing or invalid API key

402Key needs a one-time Stripe top-up

403Disabled key or unknown parameter

404Requested result, place, route, or artifact not found

409This browser already received a free key

429Free-key or request rate exceeded

500Unexpected API failure

503Temporarily unavailable; retry after Retry-After when retryable is true

{
  "error": "q is required when type=search",
  "error_code": "invalid_request",
  "status_code": 400,
  "request_id": "6cebd506b0b4c1a820da15a3",
  "retryable": false,
  "search_parameters": {
    "type": "search"
  }
}

Litescrape sells to AI agents - live prices and self-serve payment

Getting Started with Litescrape's APIs

Public endpoints

Google Search API

Google AI Overview API

Google Maps API

Google Reviews API

Google AI Mode API

Google Shopping API

Google Shopping Product API

Google Contributor Reviews API

Bing Search API

Bing Maps API

DuckDuckGo Search API

DuckDuckGo Maps API

Yelp Search API

Yelp Reviews API

Tripadvisor Search API

Tripadvisor Place API

Tripadvisor Reviews API

Apple Maps Places API

Apple Maps Reviews API

Google Maps Live Foot Traffic API

Google Maps Posts API

Google Maps Photo Metadata API

Google Play Apps APIAlpha

Google Play Games APIAlpha

Google Play Books APIAlpha

Google Play Movies APIAlpha

Google Play Product APIAlpha

Google Play Reviews APIAlpha

Apple App Store Search APIAlpha

Apple App Store Product APIAlpha

Apple App Store Reviews APIAlpha

Google Ads APIAlpha

Google Local APIAlpha

Check your balance and concurrency

Make your first request

Search Google

Get a Google AI Overview

Find Google Ads

Search Google Local

Search Google Shopping

Ask Google AI Mode

Open a Shopping product

Search Bing

Search Google Maps

Fetch Apple Maps places

Fetch Apple-only ratings and reviews

Fetch place reviews

Fetch contributor review history

Search from any MCP client

Free allowance without a key

Add your API key

Hosted endpoint

Google Search API parameters

Google AI Overview API parameters

Google Shopping API parameters

Google AI Mode API parameters

Google Shopping Product API parameters

Bing Search API parameters

Google Maps API parameters

Collect more than 20 places

Apple Maps Places API parameters

Google Reviews API parameters

DuckDuckGo Search API parameters

DuckDuckGo Maps API parameters

Bing Maps API parameters

Yelp Search API parameters

Yelp Reviews API parameters

Tripadvisor Search API parameters

Tripadvisor Place API parameters

Tripadvisor Reviews API parameters

Apple Maps Reviews API parameters

Google Contributor Reviews API parameters

Google Ads API parametersAlpha

SerpAPI parameter compatibility

Google Local API parametersAlpha

Google Play Apps API parameters Alpha

Google Play Games API parameters Alpha