Getting Started
BlueCart API is an API to retrieve public-domain data from Walmart in real-time. You can use BlueCart API to retrieve products, reviews, search results, autocomplete results and category listings from Walmart.
BlueCart API returns clean, structured JSON or CSV results. You can achieve fine-grained control over your request using the request parameters.
GET /request
Getting search result Walmart data with BlueCart API is as simple as making an HTTP GET request to the request endpoint. The only required parameters are api_key (sign up for free to get an API key) and type (which defines the type of Walmart data you'd like to retrieve).
For example, to retrieve search results ( type=search ) for the search term highlighter pens , ordered by best selling products ( sort_by=best_seller ) the BlueCart API request would be:
The search results are shown below within the search_results array. For full documentation on the search results response see the Search Results docs.
Response Times & Concurrency BlueCart API gathers data in real-time and will typically return a result in 1-6 seconds. Please inspect the HTTP Response Code and update your app accordingly.
If you need to run large volumes of requests consider using the Collections API. Collections allow you to enqueue up to 15,000 requests, run them manually or on a schedule and execute them concurrently on BlueCart API's infrastructure.
GET /request
Lets say we want to change our query to request a different type of data - information on a specific product, in this case the product with Item ID 27672251 on walmart.com . Here's the BlueCart API request to achieve that:
The result of the Product request is shown below. For full documentation on Product results see the Product Results docs.
Localizing Results to a Zipcode or Postal Code BlueCart API allows you to retrieve results as they would be seen by a user in a given zipcode or postal code by specifying the zipcode or postal code in the customer_zipcode request parameter.
For example, to request results as they would be seen by a user in US zipcode 77001 you should append the customer_zipcode=77001 request parameter.