Walmart Category API
Scrape Walmart Category data with one API call. Returns products listed in a Walmart category, up to 100 per call, with title, price, rating, review count, image, availability, and seller. Unlike keyword search this endpoint DOES return real prices, which makes it the better source for price monitoring across a product set. Category ids appear in the category URLs on a product detail response (for example 3944 for Electronics). Two upstream caveats measured against the live source: sort_by is applied loosely and does not guarantee a globally ordered page (sort client-side if you need one), and brand is not populated on category rows, so read it from GET /v1/walmart/product when you need it.
Last updated August 2026Maintained by the SocialCrawl team
Returns products listed in a Walmart category, up to 100 per call, each with title, real price, rating, review count, image, availability, and seller.
Use it to walk or price-monitor a whole Walmart category by its id, since it reports real prices. De-duplicate by product id when paging.
Searching 48 platforms in parallel
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·Utility·
Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchWhat can you do with the Category API?
The Category endpoint gives you structured Walmart data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/walmart/category?category_id=3944"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/walmart/category",
params={
'category_id': '3944',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/walmart/category?category_id=3944",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| category_id | Yes | Walmart category id, for example 3944 for Electronics. Category ids and their URLs are returned in the categories array of GET /v1/walmart/product. |
| page | No | Page number, starting at 1. Prefer the universal cursor parameter. |
| sort_by | No | Result ordering: best_match (default), price_low, price_high, best_seller, or top_rated. (best_match | price_low | price_high | best_seller | top_rated) |
| min_price | No | Lowest price to include. Must be below max_price when both are set. Applied by Walmart and approximate: it narrows the result set but occasionally returns a row outside the bound, so filter on product.price.current if you need a hard limit. |
| max_price | No | Highest price to include. Must be above min_price when both are set. Applied by Walmart and approximate: it narrows the result set but occasionally returns a row outside the bound, so filter on product.price.current if you need a hard limit. |
| zip_code | No | ZIP code used to localise availability, pickup, and shipping options. Walmart pricing and stock are store-level, so results differ by location. |
| state | No | Two-letter US state code used to localise results (for example CA, NY). |
| store_id | No | Walmart store id, to restrict results to one physical store's assortment. |
| facet | No | Opaque refinement token taken from a previous response's facet data (for example a brand or category filter). |
| country | No | Walmart marketplace as a two-letter country code: US (walmart.com, default) or CA (walmart.ca). A product id from one marketplace will not resolve in the other. (US | CA) |
| limit | No | Products per page, 1 to 100. Defaults to 40. Enforced by SocialCrawl: the page is trimmed to exactly this many rows. |
What does the Walmart Category API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "walmart",
"endpoint": "/v1/walmart/category",
"data": {
"items": [
{
"product": {
"id": "11384707978",
"url": "https://www.walmart.com/ip/Apple-AirPods-4-with-Active-Noise-Cancellation/11384707978?classType=REGULAR&athbdg=L1102",
"title": "Apple AirPods 4 with Active Noise Cancellation",
"description": "Key Feature 1. Key Feature 2. Key Feature 3. Key Feature 4. Key Feature 5",
"seller": "Walmart.com",
"brand": null,
"price": {
"current": 144.99,
"original": 179,
"currency": "USD"
},
"rating": {
"average": 4.4,
"count": 27651
},
"image_urls": "https://i5.walmartimages.com/seo/Apple-AirPods-4-with-Active-Noise-Cancellation_970671e7-764d-4536-9f51-666941f35ad3.012d4c1b577966703dc4b6947a77677b.jpeg",
"availability": "In stock",
"reviews_count": null,
"ext": {
"seller_id": "F55CDC31AB754BB68FE0B39041159D63",
"catalog_id": "4W09PR7NC59E"
}
}
},
{
"product": {
"id": "19977723464",
"url": "https://www.walmart.com/ip/Lenovo-Legion-5a-15-3-WQXGA-Laptop-Ryzen-7-250-1-6GB-1TB-NVIDIA-GeForce-RTX-5060-83Q70003US/19977723464?classType=REGULAR",
"title": "Lenovo Legion 5a 15.3\" WQXGA Laptop, Ryzen 7 250, 1 6GB, 1TB, NVIDIA GeForce RTX 5060, 83Q70003US",
"description": "Lenovo Legion 5a 15.3\" WQXGA Laptop, Ryzen 7 250, 1 6GB, 1TB, NVIDIA GeForce RTX 5060, 83Q70003US",
"seller": "Walmart.com",
"brand": null,
"price": {
"current": 1249,
"original": 2099.99,
"currency": "USD"
},
"rating": {
"average": 4.3,
"count": 6
},
"image_urls": "https://i5.walmartimages.com/seo/Lenovo-Legion-5a-15-3-WQXGA-Laptop-Ryzen-7-250-1-6GB-1TB-NVIDIA-GeForce-RTX-5060-83Q70003US_e80bebe5-54ef-493b-9279-30b80bf418c4.7f12718d5f45e24a48da9bc53d2f8f44.jpeg",
"availability": "In stock",
"reviews_count": null,
"ext": {
"seller_id": "F55CDC31AB754BB68FE0B39041159D63",
"catalog_id": "26V6GBJCQVIW"
}
}
}
],
"total": null,
"dropped": 0
},
"credits_used": 5,
"credits_remaining": 9999,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoiMiIsInAiOiJwYWdlIn0",
"has_more": true,
"page_size": 48
}
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the Walmart Category API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 48 platforms covering 10B+ monthly active users.
One schema, every platform
Query 48 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language — ready to use.
See your data before you code
Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usWhere do I find a Walmart category id?
Does the category endpoint return real prices?
How many products come back per call?
Why is brand empty on category results?
What if the category id does not exist?
Ask AI about SocialCrawl
Ready to scrape Walmart Category data?
Get your API key and start pulling Walmart data in under 60 seconds.