> ## 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 Product Offers

> This endpoint returns the current inventory levels for each seller of a specific Walmart product.

<Warning>
  **🚧 Coming Soon**: This endpoint is currently in development and will be available soon. Stay tuned for updates!
</Warning>

<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 **5 credits** 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 request theme={null}
  curl -X GET "http://rivin.ai/api/walmart/product/offers?walmart_product_code=1370971228" \
    -H "Content-Type: application/json" \
    -H "x-api-key: (YOUR_API_KEY_HERE)"
  ```
</RequestExample>

<ResponseExample>
  ```json API Response theme={null}
  {
    "walmart_product_code": "1370971228",
    "sellers": [
      {
        "seller_name": "Walmart.com",
        "units_in_stock": 45,
        "last_updated": "2024-01-15T10:30:00Z"
      },
      {
        "seller_name": "Third Party Seller",
        "units_in_stock": 12,
        "last_updated": "2024-01-15T09:15:00Z"
      }
    ]
  }
  ```
</ResponseExample>

<Note>
  **Inventory Tracking**: This endpoint provides real-time inventory levels for all sellers of a specific product. Data is updated frequently but may have slight delays depending on seller update frequency.
</Note>


## OpenAPI

````yaml GET /walmart/product/offers
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/offers:
    get:
      tags:
        - Walmart Products
      summary: Get Product Offers
      description: >-
        This endpoint returns the current inventory levels for each seller of a
        specific Walmart product.
      operationId: getWalmartProductOffers
      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: walmart_product_code
          in: query
          description: The Walmart product code to get inventory information for.
          required: true
          schema:
            type: string
          example: '1370971228'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Offers'
        '400':
          description: Bad request - Invalid product code
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Offers:
      type: object
      properties:
        walmart_product_code:
          description: The Walmart product code.
          type: string
        sellers:
          description: Array of seller inventory information
          type: array
          items:
            type: object
            properties:
              seller_name:
                type: string
                description: Name of the seller
              units_in_stock:
                type: integer
                description: Number of units currently in stock
              last_updated:
                type: string
                format: date-time
                description: When the inventory was last updated
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string

````