Yahoo Shopping API endpoint
Returns 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.
/yahoo-shopping/shopping-listQuery parameters:
list (required) -- a list slug from GET /yahoo-shopping/shopping-lists
(e.g. cooling-essentials).Notable response behavior:
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.list slug returns 404.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| title | 20 | “Dreo TurboPoly Fan 765S” and 19 other values |
| url | 20 | dreo.com and 2 other hosts |
| image_url | 20 | s.yimg.com |
| seller | 20 | |
| currency | 20 | USD in all 20 |
| price | 20 | 19 to 250, median 60 |
| sale_price | 20 | 19 to 200, median 55 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| list | string | Yes | List slug from GET /yahoo-shopping/shopping-lists | cooling-essentials | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yahoo-shopping/shopping-list?list=cooling-essentials" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"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
}
]
}
}Request schema
No body schema
Response schema
#/definitions/yahooshopping.shoppingListResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahooshopping.ShoppingListResponse | No | ||||
| data.items | array | No | ||||
| data.items[].currency | string | No | ||||
| data.items[].image_url | string | No | ||||
| data.items[].price | number | No | ||||
| data.items[].sale_price | number | No | ||||
| data.items[].seller | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].url | string | No | ||||
| data.list | string | No | ||||
| data.title | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/yahoo-shopping/shopping-list?list=cooling-essentials" \
-H "x-api-key: $CRAWLORA_API_KEY"