Yahoo Shopping API

Response notes

- `category` is derived from the story's own URL path (e.g. `style`, `beauty`, `home-garden`) and is omitted only if the URL doesn't match the expected `/<category>/.../article/....html` shape. - A blocked or CAPTCHA-served response returns `503`. Example response: ```json { "code": 200, "msg": "OK", "data": { "items": [ { "id": "175919542", "title": "Stylists say these are the 4 must-have denim trends for fall", "url": "https://shopping.yahoo.com/style/clothing/article/stylists-say-these-are-the-4-must-have-denim-trends-for-fall-175919542.html", "category": "style", "thumbnail_url": "https://s.yimg.com/lo/mysterio/api/example/denim.jpg" } ] } } ```

Response notes

- Pagination follows Yahoo's own path-segment scheme (`shopping.yahoo.com/<category>/<page>/`), not a query-param offset; `next_page` is omitted when the section's own pagination control has no higher page number. - Only stories whose own URL path starts with `/<category>/` are returned -- a section page's cross-category recirculation modules do not leak unrelated stories into the result set. - An unrecognized `category` value returns `400`. Example response: ```json { "code": 200, "msg": "OK", "data": { "category": "beauty", "items": [ { "id": "215349611", "title": "Brooke Shields, 61, on thinning hair, aging and the products she swears by for 2026", "url": "https://shopping.yahoo.com/beauty/article/brooke-shields-61-on-thinning-hair-aging-and-the-products-she-swears-by-for-2026-215349611.html", "category": "beauty", "thumbnail_url": "https://s.yimg.com/lo/mysterio/api/example/brooke.jpg" } ], "pagination": { "page": 1, "next_page": 2 } } } ```

Response notes

- `provider` is the original outlet Yahoo Shopping syndicates the story from (e.g. "Yahoo Life"), separate from Yahoo Shopping itself. - `paragraphs` can be an empty array for an article whose metadata loaded but whose body content did not render -- this is returned as a normal `200`, not an error. A response missing *both* metadata and body paragraphs is treated as an upstream error (parser drift or a block), not a silent empty success. - A `url` that isn't a `shopping.yahoo.com` article URL returns `400`. Example response: ```json { "code": 200, "msg": "OK", "data": { "url": "https://shopping.yahoo.com/style/clothing/article/stylists-say-these-are-the-4-must-have-denim-trends-for-fall-175919542.html", "title": "Stylists say these are the 4 must-have denim trends for fall", "description": "Hint: Skinny jeans are still out — but the newest go-to might surprise you.", "author": "Jessica Teich", "published_at": "2026-08-06T17:59:19Z", "updated_at": "2026-08-06T17:59:19Z", "section": "Clothing", "image_url": "https://s.yimg.com/lo/mysterio/api/example/denim-hero.jpg", "keywords": ["Derek Warburton", "Katelyn Joseph", "denim"], "provider": "Yahoo Life", "paragraphs": [ "Every year when fall creeps back in, I slip into mourning over two equally major things..." ] } } ```

Response notes

- This is a fixed directory of retailers Yahoo Shopping currently features -- not every online retailer, and the set can change over time. Example response: ```json { "code": 200, "msg": "OK", "data": { "stores": [ { "store": "target", "name": "Target", "logo_url": "https://s.yimg.com/lb/brands/250x250_target.png.cf.jpg" } ] } } ```

Response notes

- This is **not** a keyword search -- there is no query term. Each retailer's store page carries a fixed set of currently-featured deals (confirmed live: 10 per retailer), which changes as Yahoo's own feed updates. - `url` is the real, direct retailer product URL (e.g. `www.target.com/p/...`), decoded server-side from Yahoo's own affiliate-tracking redirect -- not the tracking link itself. - `price` is the item's regular price and `sale_price` is the current discounted price; both are omitted (zero) if not present on the upstream offer. - An unrecognized `store` slug returns `404`. Example response: ```json { "code": 200, "msg": "OK", "data": { "store": "target", "name": "Target", "offers": [ { "title": "purely elizabeth. Ancient Grain Flakes Cereal -13oz", "url": "https://www.target.com/p/purely-elizabeth-ancient-grain-flakes-granola-13oz/-/A-94967445", "image_url": "https://s.yimg.com/example/cereal.jpg", "brand": "Target", "currency": "USD", "price": 7.49, "sale_price": 5.99 } ] } } ```

Response notes

- This is a fixed directory of themed lists Yahoo Shopping currently features -- not a general list-creation feature, and the set can change over time. Example response: ```json { "code": 200, "msg": "OK", "data": { "lists": [ { "list": "cooling-essentials", "title": "Cooling Essentials", "image_url": "https://s.yimg.com/en/images/example.svg" } ] } } ```

Response notes

- `url` is the real, direct destination product URL (e.g. a brand's own site or `www.amazon.com/dp/...`), decoded server-side from Yahoo's own affiliate-tracking redirect -- not the tracking link itself. - `price` is the item's regular price and `sale_price` is the current price; they are equal when an item isn't discounted. - `currency` is always `"USD"` -- not present as an explicit field on this page's product cards, but every item observed is a US-market listing. - An unrecognized `list` slug returns `404`. Example response: ```json { "code": 200, "msg": "OK", "data": { "list": "cooling-essentials", "title": "Cooling Essentials", "items": [ { "title": "Dreo TurboPoly Fan 765S", "url": "https://www.dreo.com/products/turbopoly-fan-765s", "image_url": "https://s.yimg.com/example/fan.jpg", "seller": "Dreo", "currency": "USD", "price": 160, "sale_price": 160 } ] } } ```