API Reference
Use Crawlora's Yahoo Shopping API endpoints to extract supported public Yahoo Shopping data as structured JSON. This documentation covers 7 active endpoints including Yahoo Shopping article content, Yahoo Shopping section story stream, Yahoo Shopping homepage story stream, Yahoo Shopping curated list items, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as url, category, list, store, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/yahoo-shopping/home" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/yahoo-shopping/articleapiKey2 credits/requestReturns a single Yahoo Shopping article's full content: title, description, author, publish/update time, section, image, keywords, original publisher, and body paragraphs. Accepts a canonical shopping.yahoo.com article URL, such as one returned by the home or category story streams.
Required params: url:query
/yahoo-shopping/categoryapiKey3 credits/requestReturns a Yahoo Shopping section's editorial story feed: title, destination URL, category, and thumbnail image for each story, with page-based pagination. Sourced from Yahoo Shopping's own server-rendered section pages.
Required params: category:query
/yahoo-shopping/homeapiKey3 credits/requestReturns Yahoo Shopping's homepage editorial story feed: title, destination URL, category, and thumbnail image for each story. Sourced from Yahoo Shopping's own server-rendered homepage. This is Yahoo's shopping buying-guide/deals content site, not a product-search API -- shopping.yahoo.com no longer exposes a searchable product catalog.
Required params: None
/yahoo-shopping/shopping-listapiKey3 credits/requestReturns one curated Yahoo Shopping list's items: product title, direct destination URL, image, seller, currency, price, and sale price for each item. Sourced from the list page's own product cards. Use GET /yahoo-shopping/shopping-lists to find a list's slug.
Required params: list:query
/yahoo-shopping/shopping-listsapiKey1 credit/requestReturns Yahoo Shopping's curated shopping-lists directory: a slug, title, and image for each themed list (e.g. "Cooling Essentials", "Back to School"). Use a list's slug with GET /yahoo-shopping/shopping-list to read its items.
Required params: None
/yahoo-shopping/storeapiKey3 credits/requestReturns one retailer's current deals on Yahoo Shopping: product title, direct retailer product URL, image, brand, currency, price, and sale price for each offer. Sourced from the retailer's shopping.yahoo.com store page's own structured product data -- not a keyword search, a fixed set of currently-featured deals for that retailer. Use GET /yahoo-shopping/stores to find a retailer's slug.
Required params: store:query
/yahoo-shopping/storesapiKey1 credit/requestReturns Yahoo Shopping's retailer store directory: a slug, display name, and logo image for each retailer with a dedicated store page (e.g. Amazon, Target, Best Buy). Use a store's slug with GET /yahoo-shopping/store to read its current deals.
Required params: None
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Yahoo Shopping article content | /yahoo-shopping/article | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Yahoo Shopping section story stream | /yahoo-shopping/category | GET | 3 credits/request | category:query | View docs | Try endpoint |
| Yahoo Shopping homepage story stream | /yahoo-shopping/home | GET | 3 credits/request | None | View docs | Try endpoint |
| Yahoo Shopping curated list items | /yahoo-shopping/shopping-list | GET | 3 credits/request | list:query | View docs | Try endpoint |
| Yahoo Shopping curated shopping-lists directory | /yahoo-shopping/shopping-lists | GET | 1 credit/request | None | View docs | Try endpoint |
| Yahoo Shopping retailer store deals | /yahoo-shopping/store | GET | 3 credits/request | store:query | View docs | Try endpoint |
| Yahoo Shopping retailer store directory | /yahoo-shopping/stores | GET | 1 credit/request | None | View docs | Try endpoint |