# Social Fetch API - Walmart endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 4 documented Walmart operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/walmart/product Get Walmart product Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/walmart/product/get.mdx SDK: client.walmart.getProduct({ productId: "16101019327" }) Parameters: - productId (required, string) - Walmart item id (`16101019327`) or product page URL (`https://www.walmart.com/ip/Beautiful-3-Qt-Air-Fryer/16101019327`). Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/walmart/product?productId=16101019327" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/walmart/product/reviews List Walmart product reviews Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/walmart/product/reviews/get.mdx SDK: client.walmart.getProductReviews({ productId: "16101019327", sort: "newest" }) Parameters: - productId (required, string) - Walmart item id (`16101019327`) or product page URL (`https://www.walmart.com/ip/Beautiful-3-Qt-Air-Fryer/16101019327`). - sort (optional, string, enum: relevance | newest | oldest | highest_rating | lowest_rating | most_helpful) - Order of the reviews: `relevance` (default), `newest`, `oldest`, `highest_rating`, `lowest_rating` or `most_helpful`. - rating (optional, integer) - Only reviews with this many stars, 1 to 5. Default: every rating. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/walmart/product/reviews?productId=16101019327" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/walmart/search Search Walmart products Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/walmart/search/get.mdx SDK: client.walmart.search({ query: "air fryer" }) Parameters: - query (required, string) - Words to search for, up to 200 characters (`air fryer`). - sort (optional, string, enum: relevance | bestselling | top_rated | newest | price_high_to_low | price_low_to_high) - Order of the products: `relevance` (default), `bestselling`, `top_rated`, `newest`, `price_high_to_low` or `price_low_to_high`. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/walmart/search?query=air%20fryer" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/walmart/category/products List Walmart category products Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/walmart/category/products/get.mdx SDK: client.walmart.getCategoryProducts({ category: "5427_486190" }) Parameters: - category (required, string) - Category id (`5427`, or `5427_486190` for a subcategory) or category page URL (`https://www.walmart.com/browse/baby/5427`). - sort (optional, string, enum: relevance | bestselling | top_rated | newest | price_high_to_low | price_low_to_high) - Order of the products: `relevance` (default), `bestselling`, `top_rated`, `newest`, `price_high_to_low` or `price_low_to_high`. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/walmart/category/products?category=5427_486190" \ -H "x-api-key: YOUR_API_KEY"