> ## 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.

# Add Walmart Product To Oversight Tracking

> This endpoint adds a product to a user's tracked products in Rivin.ai's Oversight 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 requests/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**: Adding products to oversight tracking costs **0 credits**. Credits are charged daily based on your chosen oversight tier when data is queried:

  **Tier 0** (Every hour in depth): 150 credits/day - **Units in stock for EACH seller + Price history for EACH seller every hour on query**\
  **Tier 1** (Every 2 hours): 90 credits/day\
  **Tier 2** (6 hours): 35 credits/day\
  **Tier 3** (12 hours): 20 credits/day\
  **Tier 4** (Daily): 10 credits/day
</Note>

<RequestExample>
  ```bash Example request theme={null}
  curl -X POST "http://rivin.ai/api/walmart/oversight/products" \
    -H "Content-Type: application/json" \
    -H "x-api-key: (YOUR_API_KEY_HERE)" \
    -d '{
      "walmart_product_code": "1370971228"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json API Response theme={null}
  {
    "id": "ov_123456789",
    "walmart_product_code": "1370971228",
    "user_id": "user_123",
    "created_at": "2024-01-15T10:30:00Z"
  }
  ```
</ResponseExample>

<Note>
  **Oversight Tracking**: Add products to your oversight dashboard to track pricing, inventory, and sales data over time. This provides comprehensive monitoring capabilities for your product portfolio.
</Note>


## OpenAPI

````yaml POST /walmart/oversight/products
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/oversight/products:
    post:
      tags:
        - Walmart Oversight
      summary: Add Walmart Product To Oversight Tracking
      description: >-
        This endpoint adds a product to a user's tracked products in Rivin.ai's
        Oversight product.
      operationId: addWalmartOversightProduct
      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
      requestBody:
        description: Product to add to oversight tracking
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OversightProduct'
        required: true
      responses:
        '200':
          description: Product added to oversight tracking
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OversightProduct'
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    OversightProduct:
      type: object
      properties:
        id:
          description: Unique identifier for the oversight product
          type: string
        walmart_product_code:
          description: The Walmart product code being tracked
          type: string
        user_id:
          description: The user ID who is tracking this product
          type: string
        created_at:
          description: When the product was added to oversight
          type: string
          format: date-time
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string

````