> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rivin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Walmart Product Details

> This endpoint accepts a UPC, EAN, or Walmart product code and returns the matching Walmart product listing with basic product data.

<Note>
  **Rate Limit**: This endpoint has a default rate limit of **10 products/second** per account. Need higher limits? [Contact our support team](https://cal.com/rivin-ai/30min) - we can accommodate any rate limit requirements on request.
</Note>

<Note>
  **Credit Cost**: This endpoint costs **1 credit** per successful request. Credits are only deducted when the API call succeeds and returns product data. Failed requests (errors, rate limits, etc.) do not consume credits.
</Note>

<RequestExample>
  ```bash Example UPC Request theme={null}
  curl -X GET "http://rivin.ai/api/walmart/product/details?upc=040094535309" \
    -H "Content-Type: application/json" \
    -H "x-api-key: (YOUR_API_KEY_HERE)"
  ```
</RequestExample>

<ResponseExample>
  ```json API Response theme={null}
  {
    "upc": "040094535309",
    "ean": "0400945353092",
    "walmart_product_code": "1288567194",
    "categories": ["Home", "Appliances", "Kitchen Appliances", "Blenders", "Hamilton Beach Blenders"],
    "buybox_price": 32.88,
    "customer_rating": 4.3,
    "number_of_reviews": 2846
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /walmart/product/details
openapi: 3.1.0
info:
  title: Rivin.ai Walmart API
  description: >-
    API for retrieving Walmart product information, price history, and managing
    oversight tracking
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://rivin.ai/api
    description: Production API server
security: []
paths:
  /walmart/product/details:
    get:
      tags:
        - Walmart Products
      summary: Get Walmart Product Details
      description: >-
        This endpoint accepts a UPC, EAN, or Walmart product code and returns
        the matching Walmart product listing with basic product data.
      operationId: getWalmartProductDetails
      parameters:
        - name: x-api-key
          in: header
          description: >-
            Your unique API key for authentication. This key is required in the
            header of all API requests, to authenticate your account and access
            Rivin.ai's services. Get your API key through the
            [Settings](https://rivin.ai/settings) page.
          required: true
          schema:
            type: string
        - name: upc
          in: query
          description: >-
            The 12-digit universal product code (upc) that will be used to
            search Walmart's catalog.
          schema:
            type: string
          example: '040094535309'
        - name: ean
          in: query
          description: >-
            The 13-digit european article number (ean) that will be used to
            search Walmart's catalog.
          schema:
            type: string
          example: '0400945353092'
        - name: walmart_product_code
          in: query
          description: >-
            The (typically) 6-12 digit walmart product_code that will be used to
            search Walmart's catalog.



            Note: This endpoint accepts one of three identifier types (UPC, EAN,
            or Walmart product code). Only one parameter should be provided per
            request.
          schema:
            type: string
          example: '1288567194'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalmartProduct'
        '400':
          description: Bad request - Invalid parameters or missing required fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    WalmartProduct:
      type: object
      properties:
        upc:
          description: The 12-digit universal product code (upc).
          type: string
        ean:
          description: The 13-digit european article number(ean).
          type: string
        walmart_product_code:
          description: The (typically) 6-12 digit walmart product code.
          type: string
        brand:
          description: The brand of the product
          type: string
        name:
          description: The product name
          type: string
        categories:
          description: >-
            The categories Walmart categorizes the product into. This includes
            the main category all the way down to sub-categories.
          type: array
          items:
            type: string
        buybox_price:
          description: >-
            The current price of the product buybox in USD down to the nearest
            cent.
          type: number
          format: float
        customer_rating:
          description: The customer rating between 1 to 5 stars.
          type: string
        number_of_reviews:
          description: The number of reviews.
          type: string
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string

````