Crawlora MCP
Hosted MCP: 1873 structured web-data tools for search, maps, commerce, social, gaming & finance.
Open source Repository Open in the app JSON README (API)
About
Hosted MCP: 1873 structured web-data tools for search, maps, commerce, social, gaming & finance.
Details
- Kind
- MCP servers
- Topic
- Maps, weather & travel
- Publisher
- net.crawlora
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.16.2
- Stars
- 1
- Last push
- 2026-09-07T15:59:02Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:49
- Updated
- 2026-09-07 16:14:06
- Origin id
net.crawlora/crawlora-mcp
README
# Crawlora MCP
[](https://crawlora.net/mcp?utm_source=github&utm_medium=referral&utm_campaign=crawlora-mcp)
[](https://crawlora.net/docs?utm_source=github&utm_medium=referral&utm_campaign=crawlora-mcp)
[](https://modelcontextprotocol.io)
[](https://smithery.ai/servers/crawlora/crawlora)
[](https://glama.ai/mcp/servers/Crawlora-org/crawlora-mcp)
**Crawlora MCP** is a **hosted** Model Context Protocol server that gives AI clients and
agents **1873 structured public‑web‑data tools** across 215 platform groups — search, maps,
e‑commerce, social, finance, travel, app stores, media, and reviews — each returning clean,
normalized **JSON** instead of HTML to parse.
> **Two ways to use it:** connect any MCP client to the **hosted** endpoint
> (`https://mcp.crawlora.net/mcp`), or run the small **open‑source local server** in this repo
> (`npx` / Docker, stdio) — both expose the same tools and authenticate with your Crawlora API
> key. Start free with **2,000 credits/month** (no card) at **[crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-mcp)**.
## Connection
| | |
|---|---|
| **Endpoint** | `https://mcp.crawlora.net/mcp` |
| **Transport** | Streamable HTTP |
| **Auth** | `Authorization: Bearer <CRAWLORA_API_KEY>` (preferred) — `x-api-key: <key>` also accepted |
| **Get a key** | [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-mcp) (free 2,000 credits/mo) |
| **Server card** | https://crawlora.net/.well-known/mcp/server-card.json |
A missing or invalid API key returns `401`.
## Connect your client
Crawlora MCP works with any MCP‑capable client. Pick yours below — they all point at the same
hosted endpoint (`https://mcp.crawlora.net/mcp`, Streamable HTTP) and authenticate with your
`CRAWLORA_API_KEY`. Prefer keeping the key in an environment variable over pasting it literally,
and never commit it. Ready‑to‑paste files for each client live in [`examples/`](examples/).
### Claude Code (CLI)
```bash
claude mcp add --transport http crawlora https://mcp.crawlora.net/mcp \
--header "Authorization: Bearer ${CRAWLORA_API_KEY}"
```
Adds at `local` scope by default. Use `--scope user` to make it available in every project, or
`--scope project` to write a shared `.mcp.json`. Confirm with `claude mcp list`.
### Claude Desktop
Settings → Developer → **Edit Config**, then add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"crawlora": {
"url": "https://mcp.crawlora.net/mcp",
"transport": "streamable-http",
"headers": { "Authorization": "Bearer YOUR_CRAWLORA_API_KEY" }
}
}
}
```
### Cursor
Project‑local `.cursor/mcp.json` (or `~/.cursor/mcp.json` for all projects):
```json
{
"mcpServers": {
"crawlora": {
"url": "https://mcp.crawlora.net/mcp",
"headers": { "Authorization": "Bearer ${CRAWLORA_API_KEY}" }
}
}
}
```
### Codex CLI
```bash
codex mcp add crawlora \
--url https://mcp.crawlora.net/mcp \
--bearer-token-env-var CRAWLORA_API_KEY
```
### VS Code (GitHub Copilot)
`.vscode/mcp.json` (project) or your user `mcp.json`:
```json
{
"servers": {
"crawlora": {
"type": "http",
"url": "https://mcp.crawlora.net/mcp",
"headers": { "Authorization": "Bearer ${env:CRAWLORA_API_KEY}" }
}
}
}
```
### Windsurf
`~/.codeium/windsurf/mcp_config.json` (note the `serverUrl` key):
```json
{
"mcpServers": {
"crawlora": {
"serverUrl": "https://mcp.crawlora.net/mcp",
"headers": { "Authorization": "Bearer ${env:CRAWLORA_API_KEY}" }
}
}
}
```
### Gemini CLI
`~/.gemini/settings.json` (note the `httpUrl` key):
```json
{
"mcpServers": {
"crawlora": {
"httpUrl": "https://mcp.crawlora.net/mcp",
"headers": { "Authorization": "Bearer YOUR_CRAWLORA_API_KEY" }
}
}
}
```
### Cline / Roo Code
Add to `cline_mcp_settings.json` using the generic remote shape — full walkthrough in
[`llms-install.md`](llms-install.md):
```json
{
"mcpServers": {
"crawlora": {
"url": "https://mcp.crawlora.net/mcp",
"transport": "streamable-http",
"headers": { "Authorization": "Bearer ${CRAWLORA_API_KEY}" }
}
}
}
```
### Other clients
Any client that speaks **Streamable HTTP** can use the generic config in
[`examples/mcp.json`](examples/mcp.json). **stdio‑only** clients (e.g. Zed) should run the
[local server](#run-it-locally-open-source-server) below and point at its `npx` command.
## Run it locally (open‑source server)
This repo also ships a small **stdio** MCP server (`index.mjs`) that exposes the same **1873
tools**, each wrapping the Crawlora REST API (`https://api.crawlora.net/api/v1`) with your
`CRAWLORA_API_KEY`. Useful if you'd rather run the server yourself than use the hosted endpoint.
```bash
# Node 20+ (no install)
CRAWLORA_API_KEY=your-key npx -y crawlora-mcp
# or from a clone
npm install && CRAWLORA_API_KEY=your-key node index.mjs
# or Docker
docker build -t crawlora-mcp . && docker run -i -e CRAWLORA_API_KEY=your-key crawlora-mcp
```
Client config (stdio):
```json
{
"mcpServers": {
"crawlora": {
"command": "npx",
"args": ["-y", "crawlora-mcp"],
"env": { "CRAWLORA_API_KEY": "your-key" }
}
}
}
```
The tool definitions in [`tools.json`](tools.json) are generated from Crawlora's published API
catalog; each carries its real input schema and maps to a single REST endpoint.
## Hosted MCP (recommended)
Just paste the URL into your client settings. No Node.js required.
```text
https://mcp.crawlora.net/mcp
```
Header:
`x-api-key`: `<your-api-key>`
Get a key at [crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-mcp).
Every account includes **2,000 free credits / month** with no credit card required.
---
## Tools
The complete tool catalog is generated from [`tools.json`](./tools.json) so MCP directories can index it.
<!-- BEGIN MCP.SO TOOLS: generated from tools.json; do not edit manually -->
### `accor_amenities`
Accor amenity reference catalog. Returns the anonymous public Accor amenity catalog with stable amenity codes, labels, categories, and display ordering. It is reference data for interpreting hotel search facets; booking, rates, rooms, reviews, and account data are excluded.
### `accor_brands`
Accor brand directory. Returns the Accor brand directory published on the public brands page, with each brand's name, slug, and source URL. Booking, rates, rooms, reviews, contacts, and location are excluded.
### `accor_catalog_hotels`
Search the Accor hotel catalog. Searches Accor's anonymous public hotel catalog by text, hotel code, or latitude/longitude radius. Results contain static property identity and broad location metadata plus catalog relevance/distance; contact details, precise hotel coordinates, payment, loyalty, media, rates, rooms, reviews, and booking data are excluded.
### `accor_destination_hotels`
Accor hotels in a destination. Returns the static list of hotels published on one Accor destination directory page (world, continent, country, region, department, city, district, or place), optionally narrowed by a theme facet. Each hotel carries its code, name, source URL, and broad city/country. Booking, rates, rooms, reviews, contacts, and precise location are excluded.
### `accor_property`
Accor hotel metadata. Returns static public metadata for one Accor hotel code, including name, brand, city/country, explicitly listed amenities, and published check-in/check-out times. Booking, rates, rooms, reviews, contacts, and precise location are excluded.
### `accor_search`
Search Accor hotels. Searches the public Accor hotel index by destination or hotel name, with optional country, city, brand, star, page, and page-size filters. Results contain static hotel identity, location labels, ratings, and source URLs; booking, rates, rooms, reviews, loyalty, and payment flows are excluded.
### `accor_search_details`
Accor place coordinates and viewport. Resolves an anonymous Accor search suggestion identifier to its description, coordinates, viewport, radius, and address components. It uses the same public place-details source as the Accor search box; booking, rates, rooms, reviews, and account data are excluded.
### `accor_search_suggest`
Accor destination and hotel search suggestions. Returns anonymous Accor typeahead suggestions for a partial destination or hotel query, including destination/place and hotel identifiers, types, labels, and match metadata. It uses the public search-box suggestion source only; booking, rates, rooms, reviews, and result-list requests are excluded.
### `adidas_product`
Get an Adidas product. Returns normalized product-detail data for one Adidas SKU: name, brand, category, description, pricing (current/standard/sale), images, and every purchasable size variant. product_id is the Adidas SKU (e.g. JI0397), taken from a search result's products[].id field or the trailing segment of an Adidas product page URL. An unknown product_id returns a not-found error.
### `adidas_product_review_topics`
Get Adidas review topics for a product. Returns the topics an Adidas product model's customer reviews can be filtered by -- the "filter by topic" chips the product page shows, commonly satisfaction, comfort, color, purchase, fit, appearance, quality and style. Feed a topics[].topic value back to /adidas/product/reviews as its topic parameter to return only reviews about that aspect. The topic vocabulary is per model, not a fixed list: a shoe exposes fit and comfort topics that an accessory does not, so read it per model rather than hard-coding it. model_number is the Adidas model number (e.g. SAMBAU2312) -- NOT the SKU: take it from an adidas_search result's products[].model_number field. A model with no reviews, including a well-formed but unrecognized model_number, returns an empty topics list rather than an error. Note the label field is a display form of topic, not translated text: Adidas returns the same English values for every locale on this route.
### `adidas_product_reviews`
Get Adidas product reviews. Returns one page of customer reviews for an Adidas product model, plus the model's rating summary: overall rating, star histogram, percentage of reviewers who recommend it, per-attribute averages (Size, Width, Comfort, Quality with their own scale labels), and Adidas's AI-generated review digest when one exists. Each review carries the rating, headline, body, author nickname, purchased colorway, helpful/not-helpful vote counts, badges, customer photos, and submission time. model_number is the Adidas model number (e.g. SAMBAU2312) -- NOT the SKU: take it from an adidas_search result's products[].model_number field, which is a different value from products[].id. Reviews are returned 10 per page. Reviews are scoped to review text written in the requested locale's language, and most of the US catalog's reviews are English, so a non-English locale commonly returns rating statistics and a localized summary with an empty reviews list. A model with no reviews -- including a well-formed but unrecognized model_number -- returns an empty reviews list rather than an error, because Adidas answers 200 with a zero count rather than 404.
### `adidas_search`
Search or browse Adidas products. Searches Adidas.com product listings by keyword, or browses a category listing by taxonomy slug, with real pagination and sort options. Exactly one of query or category is required. Returns normalized product summaries (title, price, rating, images, color variants) plus facet filter groups, sort options, and (for category browse) a breadcrumb trail. Keyword search is best-effort relevance, not a guaranteed match: an obscure keyword returns whatever Adidas's own search index surfaces. A genuinely empty keyword search returns an empty product list, and requesting a page beyond the available result pages (or an unknown category) returns a not-found error. Category values are the path segment after /us/ in an Adidas category URL (e.g. women-athletic_sneakers); they can also be read from the url fields of a search/category response's own filters and breadcrumbs. Facets are applied by composing them into the category slug rather than by a separate parameter: each filters[].values[].slug is a token you splice into the category value (e.g. category=women-black-athletic_sneakers applies the Color=Black facet, and category=women-athletic_sneakers-prime applies Shipping=PRIME). Use filters[].key (the facet's stable name, e.g. searchcolor) rather than filters[].id, which is an opaque per-deployment UUID that cannot be used to build a request. Note the token's position within the slug varies by facet, so compose from a slug you have seen rather than assuming a fixed order.
### `adidas_store`
Get an Adidas store. Returns normalized detail for one Adidas retail store: name, status, phone, description, full address, coordinates, opening hours, and in-store services (e.g. Click and Collect, Free Wi-Fi). store_id is the numeric Adidas store id, taken from an adidas-stores response's stores[].id field. An unknown store_id returns a not-found error.
### `adidas_stores`
Find nearby Adidas stores. Returns Adidas physical retail stores nearest to a coordinate, sourced from Adidas's own store-finder API: name, address, phone, coordinates, distance in miles, opening hours, and in-store feature flags. lat and lng are both required. Adidas's upstream ignores a caller-supplied radius and returns the nearest ~20 stores ordered by distance. A location with no stores returns an empty list rather than an error.
### `adidas_suggest`
Get Adidas search suggestions. Returns the top matching products for a partial query, the same search-as-you-type preview Adidas's own search box shows. Adidas has no separate term-autocomplete index, so each suggestion is a matching product (id, title, url, image, price) rather than a completed search phrase. Best-effort relevance: an obscure query returns whatever Adidas's own search surfaces.
### `agoda_activities_search`
Search Agoda activities. Returns Agoda activities (tours, attractions, experiences) matching a free-text keyword and/or a city. When keyword is omitted, the resolved city's name is used instead to return a general listing of activities in that city. Callers may supply a known Agoda city id or a free-text city name for the city filter; when both are supplied city_id takes precedence. Credential-free public data from Agoda's own destination search.
### `agoda_activity_detail`
Get Agoda activity detail. Returns full activity detail from Agoda: title, description, stated duration, categories, and content images. Credential-free public data from Agoda's own activity content source.
### `agoda_flights_itinerary_amenities`
Get Agoda flight segment amenities. Returns real-content amenities (aircraft type, seat layout, meals, entertainment, wifi) for one or more flight segments. Copy the segments straight from a flight search response's own segment fields. Credential-free public data from Agoda's own flight content service.
### `agoda_flights_search`
Search Agoda one-way flights. Returns bookable one-way flight itineraries between two IATA airport codes for a departure date, including per-segment flight number, airline, times, layovers, aircraft type, and price. Resolve free-text city/airport names to codes first via the flight destination search endpoint. Credential-free public data from Agoda's own flight search.
### `agoda_flights_search_locations`
Search Agoda flight destinations/airports. Resolves a free-text city or airport name into IATA airport codes for flight search, with each city's direct and nearby airports. Credential-free public data from Agoda's own flight destination search.
### `agoda_homes_search`
Search Agoda Homes & Apartments by city. Returns Homes & Apartments results for an Agoda city: full listing detail for every matching property whose accommodation type is Apartment, drawn from the same city search as hotel search and filtered to non-hotel accommodation types. Callers may supply a known Agoda city id or a free-text city name; when both are supplied city_id takes precedence. Credential-free public data from Agoda's own hotel/home search.
### `agoda_hotel_detail`
Get Agoda hotel detail. Returns full hotel detail from Agoda: identity (name, any former name), an accommodation type code, address (street address, postal code, city, country), guest rating, a main photo, room count, hotel chain id, a long and short description, and short-form policy statements (minimum age, adult/child definitions, extra-bed and additional-room booking policy). Credential-free public data from Agoda's own hotel content source.
### `agoda_hotels_search`
Search Agoda hotels by city. Returns hotel search results for an Agoda city: the matching property ids for that city plus a direct link to each property's listing page. Callers may supply a known Agoda city id or a free-text city name; when both are supplied city_id takes precedence. Credential-free public data from Agoda's own hotel search.
### `airbnb_host`
Get Airbnb host profile. Returns a normalized Airbnb public host profile — display name, Superhost and identity-verification status, location, bio, hosting tenure, total guest-review count, and total listing count.
### `airbnb_host_listings`
Get Airbnb host listings. Returns the listings an Airbnb host manages, paginated. Page 1 comes from the host profile; deeper pages page through the host's full portfolio.
### `airbnb_host_reviews`
Get Airbnb host reviews. Returns reviews guests left for an Airbnb host, paginated, including the reviewer name and location.
### `airbnb_room`
Get Airbnb room. Returns normalized Airbnb public room details.
### `airbnb_room_calendar`
Get Airbnb room calendar. Returns public calendar month hints parsed from Airbnb room bootstrap data.
### `airbnb_room_reviews`
Get Airbnb room reviews. Returns normalized Airbnb public review snippets.
### `airbnb_search`
Search Airbnb stays. Returns normalized Airbnb public web search results.
### `allbirds_collection_products`
List Allbirds collection products. Returns normalized products from one Allbirds (https://www.allbirds.com) collection. The storefront URL is fixed server-side; 'handle' is the collection's URL slug.
### `allbirds_collections`
List Allbirds collections. Returns normalized collections from Allbirds (https://www.allbirds.com). The storefront URL is fixed server-side. Valid empty result pages return '200' with an empty collections array.
### `allbirds_page`
Get a Allbirds static page. Returns normalized static page detail for one Allbirds (https://www.allbirds.com) page handle. The storefront URL is fixed server-side.
### `allbirds_pages`
List Allbirds static pages. Returns normalized static pages from Allbirds (https://www.allbirds.com). The storefront URL is fixed server-side.
### `allbirds_product`
Get a Allbirds product. Returns normalized product detail for one Allbirds (https://www.allbirds.com) product handle. The storefront URL is fixed server-side; 'handle' is the product's URL slug.
### `allbirds_product_recommendations`
List Allbirds product recommendations. Returns normalized recommended products for one Allbirds (https://www.allbirds.com) product handle. The route handle is resolved to a Shopify product id before fetching recommendations. The storefront URL is fixed server-side.
### `allbirds_products`
List Allbirds products. Returns normalized products from Allbirds's (https://www.allbirds.com) public product catalog. The storefront URL is fixed server-side. Valid empty result pages return '200' with an empty products array.
### `allbirds_search_suggest`
Get Allbirds search suggestions. Returns products, collections, and query suggestions from Allbirds's (https://www.allbirds.com) credential-free predictive search Ajax endpoint. The storefront URL is fixed server-side.
### `allbirds_sitemap_urls`
List Allbirds sitemap URLs. Returns capped URL entries from Allbirds's (https://www.allbirds.com) child sitemaps matching the requested type. The storefront URL is fixed server-side.
### `allbirds_sitemaps`
List Allbirds sitemaps. Returns child sitemap URLs from Allbirds's (https://www.allbirds.com) '/sitemap.xml' index with inferred sitemap types. The storefront URL is fixed server-side.
### `allbirds_store`
Get Allbirds store metadata. Returns normalized storefront metadata for Allbirds (https://www.allbirds.com), sourced from credential-free storefront JSON. This endpoint is a brand-pinned wrapper around the generic Shopify store family: the storefront URL is fixed server-side, so no 'url' parameter is accepted. If the vanity domain blocks '/products.json', the service may fall back to a public '*.myshopify.com' domain discovered from the storefront page, or to the storefront's own embedded page data for storefronts that expose neither.
### `amazon_jobs_job`
Amazon Jobs single posting. Returns one Amazon.jobs posting by its numeric job id (the 'id' field returned by search). Parsed from amazon.jobs's stable server-rendered job detail page — there is no separate JSON detail endpoint upstream.
### `amazon_jobs_search`
Amazon Jobs search. Searches Amazon's public careers site (amazon.jobs) via its credential-free search JSON. Each result includes the full description and qualifications inline. 'sort' accepts 'relevant' (default, upstream relevance ranking) or 'recent' (newest posted first). Either 'q' or 'category' (or both) must be given -- 'category' filters by Amazon's own job-category taxonomy and works with no text query at all.
### `amazon_product`
Retrieve Amazon product details. Returns normalized product details for an Amazon ASIN on 'amazon.com', including pricing, availability, overview data, inline review samples, and descriptive content.
### `amazon_search`
Search Amazon products. Returns normalized Amazon search result cards for 'amazon.com'.
### `amazon_suggest`
Retrieve Amazon search suggestions. Returns typeahead keyword suggestions from Amazon's public suggestion API for 'amazon.com'.
### `anime_airing_schedule`
Upcoming anime airing schedule. Returns upcoming anime episode broadcasts (episode number, air time, countdown, and the normalized title), soonest first, paginated. Credential-free public AniList data.
### `anime_character`
Get an anime/manga character. Returns a normalized character profile by AniList id: names, image, description, gender, age, blood type, birthday, favourites, and the titles the character appears in with their billed role. Credential-free public AniList data.
### `anime_character_search`
Search anime & manga characters. Searches anime and manga characters by name. Returns character summaries (name, native name, image, favourites), paginated. Credential-free public AniList data.
### `anime_rankings`
Rank anime. Returns a filterable, sorted anime ranking. Credential-free public AniList data. Filter by season, year, format, genre, and status.
### `anime_search`
Search anime. Searches anime by free-text query. Credential-free public anime data from AniList. Returns normalized entries: titles, scores, popularity, format, status, season, genres, tags, and studios.
### `anime_title`
Get an anime. Returns a normalized anime by AniList id: titles (romaji/english/native), MyAnimeList id, scores, popularity, favourites, format, status, season, episodes, duration, genres, ranked tags, studios, dates, description, images, and next-airing countdown. Pass mal=true to additionally enrich the response with the MyAnimeList community score (mal block: score on a 0-10 scale, plus scored-by count), scraped credential-free from the public MAL page. Credential-free public AniList data.
### `anime_title_characters`
List an anime's characters. Returns an anime's cast (character name, native name, billed role, image, favourites), paginated. Credential-free public AniList data.
### `anime_title_recommendations`
List an anime's recommendations. Returns community-recommended titles for an anime, each with a recommendation rating and the full normalized media entry, paginated. Credential-free public AniList data.
### `anime_title_staff`
List an anime's staff. Returns the people credited on an anime (name, production role, occupations, image), paginated. Credential-free public AniList data.
### `apk_teardown_compare_ownership`
Compare two apk-teardown jobs for evidence of common ownership. Compares two DIFFERENT completed jobs (not versions of the same app) for signals of common ownership -- shared signing certificate, SDK/analytics identifiers, and more.
### `apk_teardown_diff`
Diff two completed apk-teardown jobs. Compares two already-completed jobs -- typically two versions of the same app -- and returns what changed (permissions, signing, SDKs, size, and more).
### `apk_teardown_submit`
Submit an APK for static teardown analysis. Uploads a single .apk/.xapk file (up to 400MB), or set file_url to have the server fetch it from an https:// URL instead -- exactly one of "file" or "file_url" must be given, not both. Enqueues a Tier 1 static-analysis job -- manifest, permissions, signing, SDK detection, tech stack, locales, and more. Poll the returned poll_path for the result, or set webhook_url for push delivery. Identical uploads (by sha256) within 48h return the existing job instead of re-running analysis. file_url is validated (https only, must resolve to a public address -- no loopback/private/link-local targets) and every redirect hop is re-validated the same way before being followed.
### `apk_teardown_timeline`
Build a version timeline across 2+ apk-teardown jobs. Compares 2+ completed jobs the caller asserts are versions of the same app and returns the consecutive pairwise diff for each version transition, sorted by version code.
### `apple_books_audiobook`
Retrieve Apple Books audiobook details. Returns normalized audiobook metadata from Apple Books' public catalog page, including narrator, duration, audio preview, and a cross-link to the ebook edition (when one exists).
### `apple_books_audiobook_reviews`
Retrieve Apple Books audiobook customer reviews. Returns a page of an audiobook's customer reviews. The default first page is served from the audiobook's own catalog page; deeper pages (page>1 or a larger limit) page through Apple's review API directly, up to 20 per page.
### `apple_books_audiobook_search`
Search Apple Books audiobooks. Returns normalized Apple Books audiobooks from Apple's public iTunes Search API.
### `apple_books_audiobook_series`
Retrieve an Apple Books audiobook series and its full audiobook list. Returns series metadata and the full ordered list of audiobooks in the series from Apple Books' public catalog page. An audio-book-series is a catalog resource distinct from a book-series, even for the same conceptual series.
### `apple_books_audiobook_similar`
Retrieve "Customers Also Bought" audiobooks. Returns the related audiobooks shown on the Apple Books catalog page.
### `apple_books_author`
Retrieve an Apple Books author's bibliography. Returns author metadata and their full ebook (and audiobook, where available) bibliography from Apple Books' public catalog page.
### `apple_books_book`
Retrieve Apple Books book details. Returns normalized book metadata from Apple Books' public catalog page, including ISBN, page count, publisher, audience, rating histogram, and series linkage.
### `apple_books_book_reviews`
Retrieve Apple Books customer reviews. Returns a page of a book's customer reviews. The default first page is served from the book's own catalog page; deeper pages (page>1 or a larger limit) page through Apple's review API directly, up to 20 per page.
### `apple_books_book_similar`
Retrieve "Customers Also Bought" books. Returns the related books shown on the Apple Books catalog page.
### `apple_books_charts`
Retrieve Apple Books chart rankings. Returns Apple Books chart rankings from Apple's public marketing-tools RSS JSON feed. Supported collections are 'top-free' and 'top-paid'.
### `apple_books_search`
Search Apple Books titles. Returns normalized Apple Books ebooks from Apple's public iTunes Search API.
### `apple_books_series`
Retrieve an Apple Books series and its full book list. Returns series metadata and the full ordered list of books in the series from Apple Books' public catalog page.
### `apple_jobs_job`
Apple Jobs single posting. Returns one Apple Careers posting by its job id (the 'id' field returned by search, e.g. '200674676-0836' for a specific requisition or 'PIPE-200314122' for an evergreen/pipeline retail role). Parsed from jobs.apple.com's server-rendered job detail page.
### `apple_jobs_search`
Apple Jobs search. Searches Apple's public careers site (jobs.apple.com) via its server-rendered search page's embedded job data. Page size is fixed by Apple at 20 results. Search results carry identity/location/team metadata only — call the job endpoint for the full description and qualifications.
### `apple_maps_autocomplete`
Get Apple Maps search suggestions for a partial query. Returns Apple Maps typeahead suggestions for a partial query near a coordinate: query completions, matching businesses (resolved to the same place summary the search endpoint returns, with the place ID the place endpoint takes), and addresses.
### `apple_maps_categories`
List Apple Maps browse categories for an area. Returns the "Find Nearby" browse categories Apple Maps offers for an area (for example Restaurants, Coffee Shops, Gas Stations, Hotels, Parking, Grocery Stores), each with the key and name the category-search endpoint takes. The set is location-aware.
### `apple_maps_category_search`
Browse one Apple Maps category near a coordinate. Returns places in one browse category near a coordinate without a keyword, in the same shape as the search endpoint (place summaries, region, relocation flag, and the refinement filters block). The category is a name from the categories endpoint for the same area (case-insensitive) or its key; an unknown name returns 400 listing the categories available there. Filters and sort work exactly as on the search endpoint.
### `apple_maps_directions`
Get Apple Maps driving, walking, or cycling directions. Returns Apple Maps routes between an origin and a destination, with optional intermediate stops, for driving, walking, or cycling. Each route carries its name, whether it is Apple's main or an alternate route, distance, live/historic/free-flow durations, toll and highway flags, Apple's route description and traffic note, and per-leg turn-by-turn steps (maneuver, road, shield, instruction text, distance, duration); detail=full adds each leg's path as coordinates. Departure time and avoid-tolls/highways/stairs preferences are supported. Transit routing is not available.
### `apple_maps_eta`
Get Apple Maps travel-time estimates between two points. Returns Apple Maps travel-time estimates between an origin and a destination: for each transport type Apple reports (driving always; walking when requested), the live best estimate, the historic and free-flow durations, and the route distance. Cheaper than the directions endpoint when only the time and distance are needed. Apple has no cycling ETA; use the directions endpoint for cycling.
### `apple_maps_guide`
Get one Apple Guide with its places. Returns one Apple Guide (curated collection) by id: title, description, last-modified time, cover photos, source link, publisher, and every place in the guide with the publisher's blurb for it plus the place's Apple place ID, name, category, coordinates, address, phone, website, rating, price level, hours, and photo.
### `apple_maps_guides`
Browse the Apple Guides home page worldwide or for one city. Returns the Apple Guides home page for the Worldwide scope or one city: the featured guide, the guide carousels (expert recommendations, latest, and similar rows), the city shortcut list, and the browse-by-publisher list. Each guide carries its id (the value the guide endpoint takes), title, description, last-modified time, place count, cover photo, source link, and publisher; each publisher carries its id, name, subtitle, website, and guide count.
### `apple_maps_guides_cities`
List the regions and cities Apple Guides cover. Returns the Apple Guides city picker: every region (North America, Europe, Australia, and any Apple adds) with the cities it publishes guides for, each with its id, country, coordinates, and cover photo. Pass a city id to the guides home, publishers, or publisher endpoints to scope them to that city; omit it for the Worldwide scope.
### `apple_maps_guides_lookup`
Resolve up to 20 Apple Guide ids to guide summaries. Returns guide summaries (id, title, description, last-modified time, place count, cover photo, source link) for up to 20 guide ids in one call, for example the guide_ids a place carries. Ids Apple does not return are listed in not_found. Publisher details are not part of this lookup; use the guide endpoint for a single guide's publisher and places.
### `apple_maps_guides_nearby`
Get the Apple Guides curated for the area around a coordinate. Returns the guides Apple suggests for the area around a coordinate ("Guides We Love" for that location) as guide summaries, plus the Apple Guides city the area belongs to (with the city id the guides home endpoint takes). A coordinate outside any guides city returns an empty list.
### `apple_maps_guides_publisher`
Get one Apple Guides publisher and its guides. Returns one Apple Guides publisher by id: name, subtitle, website, guide count, the cities the publisher offers as filters, and its guides (each with id, title, description, last-modified time, place count, cover photo, and source link). Pass one of the publisher's own city ids as city_id to return only the guides for that city.
### `apple_maps_guides_publishers`
List Apple Guides publishers worldwide or for one city. Returns the Apple Guides "Browse by Publisher" list for the Worldwide scope or one city, sorted by name: each publisher's id (the value the publisher endpoint takes), name, subtitle, website, and number of guides. With no city_id this is the complete enumeration of every publisher Apple lists, usable as the id lookup table for the publisher endpoint.
### `apple_maps_place`
Get one Apple Maps place's full detail. Returns one Apple Maps place by its place ID: name, type, category taxonomy, coordinates, formatted and structured address, phone numbers, website, rating and review count, price level, weekly opening hours, amenities (payment, accessibility, parking, and similar yes/no attributes), photos, review snippets (text, rating, time, and source link, without reviewer identity), the business-claim link, and the IDs of Apple Guides that include the place. Accepts either the external place ID (starts with I, the place-id= value in a maps.apple.com/place URL) or the numeric ID from a search result.
### `apple_maps_place_photos`
List every photo Apple Maps carries for a place. Returns all of a place's photos (the place endpoint caps at 20): the business cover photo first when present, then the hero photo, then every categorized photo with its category (Food & Drink, Interior, Exterior, ...), width and height.
### `apple_maps_places`
Get full detail for up to 20 Apple Maps places in one call. Returns the same full detail as the place endpoint for up to 20 place IDs in a single upstream call, plus the list of requested IDs Apple did not return. Accepts the external I... form and the numeric id interchangeably.
### `apple_maps_reverse_geocode`
Reverse-geocode a coordinate with Apple Maps. Returns Apple Maps' address record for a coordinate: the matched place name and type (an address, street, or area of interest such as a neighborhood), the formatted and structured address, the matched center, the IANA timezone, and the display region.
### `apple_maps_search`
Search Apple Maps places near a coordinate. Returns Apple Maps places matching a keyword, business name, category, or street address near a coordinate. Each place carries its Apple place ID (the value the place endpoint takes), name, category, coordinates, formatted and structured address, phone, website, rating and review count, price level, weekly opening hours, and a hero photo. Apple returns a bounded set per viewport (around 25 places for the default span) with no pagination; widen the span or move the center to cover more area. When nothing matches near the center Apple may relocate the search to a default region, reported by relocated=true and the region bounds. The response's filters block lists the refinement chips Apple offers for this query and area (open now, top rated, in guides, cuisines, price bands, amenities, accolades, sort); pass their keys back as filters and sort to refine the same search.
### `apple_maps_transit_departures`
Get a transit stop's lines and live departures from Apple Maps. Returns a transit stop or station's systems (e.g. BART, Muni Metro), lines (name, shield, color), and the upcoming departures Apple Maps shows, each with the line, headsign, direction, scheduled and live times, and real-time status. Takes the stop's Apple place ID (find stops with the search endpoint, e.g. a station name). A place that is not a transit stop returns 404.
### `apple_maps_venue_browse`
Browse the stores and places inside a venue on Apple Maps. Returns an indoor venue's directory (mall, airport, stadium: categories such as Clothes, Shoes, Food, All Shops with their subcategories and levels) and, when a category is given, the places inside the venue for that category with the same summary shape as search. Find venues with the search endpoint; a place without a directory returns 404, an unknown category returns 400 listing the available ones.
### `apple_podcasts_charts`
Retrieve Apple Podcasts chart rankings. Returns Apple Podcasts show chart rankings from public iTunes RSS JSON feeds. Supported collections are 'toppodcasts' and 'topaudiopodcasts'.
### `apple_podcasts_charts_rankings`
Retrieve Apple Podcasts chart rankings by algorithm, type, and genre. Returns Apple Podcasts chart rankings from the modern podcasts.apple.com charts page, covering chart algorithms ('top', 'top-subscriber', 'top-series') crossed with entity types ('podcasts', 'podcast-episodes', 'podcast-channels') and an optional genre filter. A richer, differently-sourced capability than the legacy RSS-based '/apple-podcasts/charts' endpoint.
### `apple_podcasts_episodes_search`
Search Apple Podcasts episodes. Returns normalized Apple Podcasts episodes from Apple's public iTunes Search API.
### `apple_podcasts_new`
Retrieve Apple Podcasts curated "New" editorial shelves. Returns the curated editorial shelves from podcasts.apple.com/{country}/new (New Shows, New Seasons, New Trailers, Essentials, and other seasonal spotlights). Shelves that merely mirror a Charts Rankings query are omitted here since '/apple-podcasts/charts/rankings' already covers that data.
### `apple_podcasts_search`
Search Apple Podcasts shows. Returns normalized Apple Podcasts shows from Apple's public iTunes Search API.
### `apple_podcasts_show`
Retrieve Apple Podcasts show details. Returns normalized show metadata from Apple's public iTunes Lookup API.
### `apple_podcasts_show_episodes`
Retrieve Apple Podcasts show episodes. Returns a show and its public Apple Podcasts episodes from Apple's iTunes Lookup API.
### `apple_podcasts_show_related`
Retrieve Apple Podcasts "You Might Also Like" related shows. Returns the "You Might Also Like" rail for a single show, sourced from the modern podcasts.apple.com show page's listener-cohort recommendation data.
### `appstore_app`
Retrieve full App Store app details. Returns normalized app metadata from the App Store lookup API. Provide either 'id' (numeric track ID) or 'app_id' (bundle ID). 'id'/'app_id' can identify an iPhone, iPad, or Mac App Store listing.
### `appstore_developer`
Retrieve apps by developer ID. Returns App Store apps associated with a specific developer artist ID.
### `appstore_editorial`
Retrieve an App Store device or Arcade editorial landing page. Returns the curated editorial shelves from one of Apple's per-device App Store landing pages (the same content shown by apps.apple.com's device switcher). 'device' enum: 'iphone', 'ipad', 'mac', 'vision', 'watch', 'tv'. 'section' enum: 'main' (the device's Today/Discover/Apps & Games landing page), 'arcade' (the device's Apple Arcade landing page). Watch has no Arcade page — 'device=watch' with 'section=arcade' returns '400'.
### `appstore_editorial_category`
Retrieve an App Store category-scoped editorial page. Returns the curated editorial shelves for one device category page (e.g. "Entertainment Apps for Vision"). 'category_id' is a numeric, device-specific editorial page ID — not a static enum — discovered from an 'appstore_editorial' response for the SAME 'device', in its "Browse by Category" shelf items' 'destination_id' field. 'device' enum: 'iphone', 'ipad', 'mac', 'vision', 'watch', 'tv'.
### `appstore_list`
Retrieve App Store collection rankings. Returns ranked App Store apps from an iTunes RSS collection, optionally expanded to full lookup details. 'collection' enum: 'topfreeapplications', 'toppaidapplications', 'topgrossingapplications', 'topfreeipadapplications', 'toppaidipadapplications', 'topgrossingipadapplications', 'topmacapps', 'topfreemacapps', 'topgrossingmacapps', 'toppaidmacapps', 'newapplications', 'newfreeapplications', 'newpaidapplications'. Of the Mac collections, only 'topfreemacapps' currently returns ranked apps — 'topmacapps', 'topgrossingmacapps', and 'toppaidmacapps' are accepted but Apple's feed for them is currently empty. There is no separate Games 'collection' — combine any collection with 'category=6014' (or a Games subgenre ID, e.g. '7012' for Puzzle) to get its Games-only equivalent, e.g. Top Free Games. See the endpoint markdown for the full category ID table.
### `appstore_privacy`
Retrieve App Store privacy disclosures. Returns the app privacy cards shown on the App Store page, including data categories and purposes.
### `appstore_ratings`
Retrieve App Store ratings histogram. Returns total ratings count and the 1-5 star histogram shown on the App Store product page.
### `appstore_reviews`
Retrieve App Store reviews. Returns one page of customer reviews for an app. Provide either 'id' (numeric track ID) or 'app_id' (bundle ID).
### `appstore_search`
Search the App Store. Returns App Store search results for a term. Set 'ids_only=true' to return only app IDs. 'platform' enum: 'phone', 'pad', 'mac'.
### `appstore_similar`
Retrieve "You Might Also Like" apps. Returns the related apps shown on the App Store product page. Provide either 'id' (numeric track ID) or 'app_id' (bundle ID).
### `appstore_suggest`
Retrieve App Store search suggestions. Returns suggested search terms for the given partial keyword.
### `appstore_version_history`
Retrieve App Store version history. Returns the version history entries shown in the App Store "What's New" section.
### `arbys_categories`
List Arby's menu categories. Returns Arby's US menu's top-level categories -- Slow Roasted Beef, Crispy Juicy Chicken, Meals, Sides & Snacks, Beverages, Desserts, Kids Menu and others. Each entry's slug is the value GET /arbys/menu takes. store_id (optional, default 0) selects which pricing snapshot categories' item counts are read from; the default 0 is Arby's own reference catalog and carries no prices at all -- pass a store_id you already know (for example one you have seen on arbys.com after picking a location) to price GET /arbys/menu's items against a specific store. There is no location-lookup endpoint in this family.
### `arbys_directory`
Browse Arby's US store directory by state and city. Returns one level of Arby's US store directory: every state Arby's serves with its store count (no params), one state's cities (state given), or one city's stores (state and city given) -- id, address, and phone only, pair with GET /arbys/location for hours/amenities/status. Unlike GET /arbys/locations, this needs no coordinate; it is a plain browse of the whole ~3,200-store US chain.
### `arbys_location`
Look up one Arby's restaurant by store id. Returns one Arby's restaurant directly by its store id (e.g. one found via GET /arbys/locations), with the same address, hours, amenities, and capability fields as that endpoint's results, minus distance (there is no search center for a direct lookup).
### `arbys_locations`
Find Arby's restaurants near a coordinate. Returns Arby's restaurants within a radius of a coordinate, nearest first, with address, phone, coordinates, distance, open/closed status, hours, amenities, and pickup/delivery capability flags. Each result's store_id also prices GET /arbys/menu and GET /arbys/categories. To search from a free-text address instead of coordinates, resolve it first with GET /geocoding/search.
### `arbys_menu`
List one Arby's menu category's items with full nutrition and price. Returns the items in one Arby's menu category, each with its stable product code, name, description, image, tags, availability, a full per-serving nutrition panel (calories, total and saturated fat, trans fat, cholesterol, sodium, carbohydrate, fiber, sugar, protein and serving weight), and a price when store_id resolves to a priced catalog. Category slugs come from GET /arbys/categories. store_id (optional, default 0) is Arby's own priceless national reference catalog; pass a store_id you already know to get that store's pricing instead -- there is no location-lookup endpoint in this family, so store_id is a passthrough value, not something this API can look up for you. A price of exactly 0 on an item is a genuine free add-on, distinct from the default catalog's complete absence of pricing.
### `audible_categories`
Get Audible's genre/category tree. Returns Audible's full genre/category tree (root genres with their subgenres), including the category ids accepted by GET /audible/search's category_id filter. Credential-free public catalog data from api.audible.com.
### `audible_category`
Get one Audible category node. Returns one Audible category node and its immediate children by id — cheaper than fetching the full tree from GET /audible/categories when only one node is needed. Credential-free public catalog data from api.audible.com.
### `audible_charts`
Get an Audible chart (audible.com/charts). Returns one page of an Audible chart — a ranked list with real chart position, price, and rating that has no equivalent on api.audible.com's public JSON API. This is an HTML scrape of audible.com/charts, a different, less stable source class than the rest of this family, though its own filters (category, access level, language, duration, Audible-Originals-only) were individually verified to actually change results. category_id, access_level, and content_type=podcasts are mutually exclusive.
### `audible_editorial_list`
Get an Audible curated editorial list. Returns one of Audible's hand-curated "Popular Lists" pages, normalized into its themed shelves (heading + ordered ASINs). This is an HTML scrape of a marketing/editorial page (audible.com), not api.audible.com's JSON API — pair an ASIN from any shelf with GET /audible/products (batch) or GET /audible/product/{asin} for full title/author/price/rating detail. "Best of the Year" is not covered — its layout has no consistent structure to parse.
### `audible_product`
Get an Audible audiobook. Returns a normalized Audible audiobook: description, authors, narrators, series, category ladders, publisher, release date, runtime, language, sample audio URL, rating (overall/performance/story), and public list price. Credential-free public catalog data from api.audible.com.
### `audible_product_related`
Get Audible titles related to an audiobook. Returns Audible titles related to a given ASIN by a required relation type: same series, same narrator, same author, next in series, or raw upstream similarity. Credential-free public catalog data from api.audible.com.
### `audible_product_reviews`
Get an Audible audiobook's customer reviews. Returns a page of an Audible audiobook's customer reviews (author, title, body, overall/performance/story ratings, helpful votes, submission date). Credential-free public catalog data from api.audible.com.
### `audible_products`
Get multiple Audible audiobooks in one call. Returns normalized Audible audiobooks for up to 50 ASINs in a single request — the same fields as GET /audible/product/{asin}. Unrecognized ASINs are silently omitted rather than failing the whole batch. Credential-free public catalog data from api.audible.com.
### `audible_search`
Search Audible's catalog. Searches Audible's audiobook catalog by keyword, title, author, narrator, or category id. At least one filter is required. Credential-free public catalog data from api.audible.com.
### `audible_series`
Get an Audible series' ordered book list. Returns an Audible series and every book in it, in series order. A series has its own ASIN distinct from any book in it — find one via a book's series[].asin field from GET /audible/product/{asin}. Credential-free public catalog data from api.audible.com.
### `autotrader_dealer`
Get Autotrader dealer profile. Returns a normalized Autotrader dealer profile (name, phone, address, rating, website) plus a first page of the dealer's own current inventory as normalized vehicle summaries and the dealer's total listing count. Credential-free public data sourced from Autotrader's own server-rendered dealer profile page.
### `autotrader_search`
Search Autotrader vehicle listings. Searches Autotrader for new and used car listings, returning normalized vehicle summaries (make, model, trim, year, mileage, pricing, images) plus the total matching count. Credential-free public data sourced from Autotrader's own server-rendered search page.
### `autotrader_vehicle`
Get Autotrader vehicle listing detail. Returns a normalized Autotrader vehicle listing: full vehicle spec (make, model, trim, mileage, colors, transmission, fuel type, engine, images, pricing), the full listing description, and seller detail (dealership or private seller). Credential-free public data sourced from Autotrader's own server-rendered vehicle detail page.
### `bbb_business`
Get a Better Business Bureau business profile. Returns a normalized bbb.org business profile: BBB rating letter grade and reasons, accreditation status and since-date, years in business, BBB file/incorporation dates, entity type, contact info, business categories, social media, and a short latest-reviews preview. Credential-free public Better Business Bureau data.
### `bbb_business_complaints`
Get a Better Business Bureau business's complaint history. Returns a business's BBB complaint history: total complaint count, complaints closed in the last 12 months, and per-complaint detail (date, type, status, narrative text, and any business response / customer answer thread). A business with no filed complaints returns total_complaints 0 and an empty complaints list -- this is a normal result, not an error. Credential-free public Better Business Bureau data.
### `bbb_business_more_info`
Get a Better Business Bureau business's full rating reasons and service area. Returns a business's full per-factor "Reasons for Rating" list and full service-area list, from the separate BBB business profile /more-info sub-page. The bbb-business endpoint's own rating_reasons field is read from the main profile page and typically holds only one generic boilerplate bullet regardless of actual rating; this endpoint fetches the richer, business-specific list instead. Service area is business-conditional -- some businesses render no service-area section at all, in which case service_areas is empty. Credential-free public Better Business Bureau data.
### `bbb_business_reviews`
Get a Better Business Bureau business's customer reviews. Returns a business's full customer-review list (author, star rating, date, text, and any business response thread), paginated 10 per page, plus the average star rating and total review count. Credential-free public Better Business Bureau data. Unlike the other bbb-business-* endpoints, this one is fetched with browser impersonation rather than plain direct HTTP -- see the family's maintenance note for why.
### `bbb_category`
Browse a Better Business Bureau category. Browses bbb.org businesses by category and location directly, without a free-text search query. Returns the same normalized business-result shape as bbb-search. Credential-free public Better Business Bureau data.
### `bbb_scamtracker_detail`
Get a Better Business Bureau Scam Tracker report. Returns one normalized BBB Scam Tracker consumer scam report: description, dollars lost, targeted person's location, scammer location/email/phone/URL (when known), scam type, business name used, and date reported. Credential-free public Better Business Bureau data.
### `bbb_scamtracker_search`
Search Better Business Bureau Scam Tracker reports. Searches bbb.org Scam Tracker's consumer-reported-scam database by free-text query, scam category, targeted-victim state/province, reported-scammer state/province, report-date range, and/or dollar-loss range, paginated 10 results/page. Omit every filter to browse the most-recent-first feed. Credential-free public Better Business Bureau data. This is a separate BBB dataset from the bbb-search/bbb-business/bbb-business-complaints business-rating family -- consumer-reported scam incidents, not business ratings.
### `bbb_scamtracker_state_stats`
Get Better Business Bureau Scam Tracker state/province aggregate stats. Returns aggregate scam-report stats per US state and Canadian province for a given time window: report counts, dollar losses, per-capita rates, year-over-year change, and top scam-type breakdown. This calls the same JSON API the BBB Scam Tracker heatmap dashboard's own frontend uses -- not an HTML scrape. Credential-free public Better Business Bureau data.
### `bbb_search`
Search Better Business Bureau businesses. Searches bbb.org for businesses by name or category near a location. Returns each business's BBB rating letter grade, accreditation status, categories, service areas, contact info, and profile URL. Credential-free public Better Business Bureau data.
### `bbc_article`
Get BBC News article content. Returns a BBC News article's public metadata and body paragraphs from a canonical article URL. Live pages are not supported.
### `bbc_headlines`
Get BBC News section headlines. Returns fresh headlines from a public BBC News RSS section. section defaults to world.
### `bbc_live`
Get a BBC News live-page text snapshot. Returns the current server-rendered text updates from one canonical BBC News live URL. It does not subscribe to updates or return broadcast, player, or stream data.
### `bbc_search`
Search public BBC pages. Returns a bounded page of public BBC search-result metadata. Media entries link only to their BBC landing pages; streams, downloads, and transcripts are not returned.
### `bestbuy_brands`
Get Best Buy's full brand directory. Returns Best Buy's full brand directory (name, category id, url), sourced from the site's own "Name Brands" page. Each id is directly usable as bestbuy_category's category_id input.
### `bestbuy_categories`
Get Best Buy's top-level shopping departments. Returns Best Buy's top-level shopping departments (name, category id, url), sourced from the homepage's own category carousel. Each id is directly usable as bestbuy_category's category_id input.
### `bestbuy_categories_trending`
Get Best Buy's fine-grained trending product-type categories. Returns Best Buy's fine-grained, often deeply-nested product-type categories (e.g. "Windows Laptops", "55-Inch TVs (55 - 64 in)", "PS5 Consoles") sourced from the homepage's own "Best Selling" section -- much more specific than bestbuy_categories' ~25 top-level departments. Each id is directly usable as bestbuy_category's category_id input.
### `bestbuy_category`
Get a Best Buy category's product listing. Returns one page (up to 24) of one Best Buy category's normalized product listing (sku, title, url, image, price, rating, review count). category_id is a Best Buy category id, e.g. pcmcat138500050001, found in a category page URL's trailing <id>.c?id=<id> segment. page is the optional 1-indexed page number (defaults to 1); requesting a page past the last one returns an empty products list, not an error.
### `bestbuy_category_subcategories`
Get a Best Buy category's own sibling/child categories. Returns a Best Buy category's own sibling/child category set (name, category id, url), sourced from that category page's own "Category" filter facet. Each id is directly usable as bestbuy_category's category_id input. category_id is a Best Buy category id, e.g. pcmcat138500050001, found in a category page URL's trailing <id>.c?id=<id> segment. A leaf category with no siblings returns an empty list, not an error.
### `bestbuy_product`
Get a Best Buy product's detail. Returns one Best Buy product's normalized detail (name, brand, model, color, price, availability, rating, images, breadcrumbs), sourced from the product page's own schema.org Product structured-data block. sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs.
### `bestbuy_product_questions`
Get a Best Buy product's customer questions and answers. Returns the customer questions (with answers, when present) Best Buy embeds directly on a product's page: question text, answer text, who answered, and when. sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs. A product with no questions asked yet returns an empty list, not an error.
### `bestbuy_product_related`
Get a Best Buy product's related products. Returns the organic (non-sponsored) related products Best Buy embeds in a product page's own comparison table (sku, name, url, image, price). sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs. A product page with no comparison table returns an empty list, not an error.
### `bestbuy_product_reviews`
Get a Best Buy product's customer reviews. Returns page 1 (up to 20) of one Best Buy product's normalized customer reviews (rating, title, text, author, posted date, tags such as Verified Purchaser, recommended flag, helpful/unhelpful counts), sourced from the product's dedicated reviews page. sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs.
### `bestbuy_search`
Search Best Buy's product catalog. Returns one page (up to 24) of one Best Buy keyword search's normalized product listing (sku, title, url, image, price, rating, review count). q is free-text search keywords, e.g. "laptop". page is the optional 1-indexed page number (defaults to 1); requesting a page past the last one returns an empty products list, not an error.
### `bestbuy_stores`
Get Best Buy's physical stores in one city. Returns Best Buy's physical store locations in one city (name, address, phone, coordinates, rating, hours), sourced from Best Buy's own SEO store directory. state is one of the 50 US state codes plus dc and pr: 'al', 'ak', 'az', 'ar', 'ca', 'co', 'ct', 'de', 'dc', 'fl',