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

# Create Product

> Create a new product with URL analysis or manual input.
This is Step 1 in the product video generation workflow.


Create a product entry from a URL or manual product information. The system will extract product details automatically.

## Example Usage

```bash theme={null}
curl -X POST 'https://api.jogg.ai/v2/product' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com/product/amazing-gadget"
  }'
```

## Related Guides

<CardGroup cols={2}>
  <Card title="URL to Video Guide" href="/api-reference/v2/API Documentation/URLtoVideo">
    Complete product video workflow
  </Card>
</CardGroup>


## OpenAPI

````yaml POST /v2/product
openapi: 3.0.1
info:
  title: JoggAI OpenAPI v2
  description: >
    JoggAI OpenAPI v2 provides a comprehensive suite of endpoints for creating
    and managing AI-powered video content.


    ## Authentication

    All API requests require authentication using an API key provided in the
    `x-api-key` header.


    ## Base URL

    Production: https://api.jogg.ai/v2


    ## Rate Limiting

    API calls are subject to rate limiting based on your subscription plan.


    ## Error Handling

    All endpoints return standard HTTP status codes along with detailed error
    messages in the response body.
  version: 2.0.0
  license:
    name: MIT
servers:
  - url: https://api.jogg.ai
    description: Production server
security:
  - apiKeyAuth: []
tags:
  - name: Video
    description: Video creation and management operations
  - name: Avatar
    description: Avatar management and creation operations
  - name: Voice
    description: Voice and timbre management operations
  - name: Asset
    description: Asset management including music, scripts, and uploads
  - name: Template
    description: Template management operations
  - name: Product
    description: Product management operations
  - name: User
    description: User account operations
  - name: Webhook
    description: Webhook endpoint management for event notifications
paths:
  /v2/product:
    post:
      tags:
        - Product
      summary: Create Product V2
      description: |
        Create a new product with URL analysis or manual input.
        This is Step 1 in the product video generation workflow.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  description: Product URL to crawl information from
                  example: https://www.amazon.com/product/...
                name:
                  type: string
                  description: Product name (required if no URL)
                  example: Physicians Formula Happy Booster Heart Blush
                description:
                  type: string
                  description: Product description and selling points
                  example: Brush on a radiant blushing glow...
                target_audience:
                  type: string
                  description: Target audience
                  example: Beauty enthusiasts
                media:
                  type: array
                  description: Media resources array
                  items:
                    type: object
                    properties:
                      type:
                        type: integer
                        description: |
                          Media type:
                          * 1 - Image
                          * 2 - Video
                        enum:
                          - 1
                          - 2
                        example: 1
                      name:
                        type: string
                        example: product.jpg
                      url:
                        type: string
                        example: https://res.jogg.ai/media.jpg
                      description:
                        type: string
                        example: Product front view
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/BaseResponse'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/ProductInfo'
components:
  schemas:
    BaseResponse:
      type: object
      required:
        - code
        - msg
      properties:
        code:
          type: integer
          description: |
            Business status code:
            * 0 - Success
            * 10104 - Record not found
            * 10105 - Invalid API key
            * 18020 - Insufficient credit
            * 18025 - No permission to call APIs
            * 40000 - Parameter error
            * 50000 - System error
          example: 0
        msg:
          type: string
          description: Response message
          example: Success
    ProductInfo:
      type: object
      properties:
        product_id:
          type: string
          description: Product ID
          example: NTQ0MTkzNjg
        url:
          type: string
          description: Product URL
        name:
          type: string
          description: Product name
        description:
          type: string
          description: Product description
        target_audience:
          type: string
          description: Target audience
        media:
          type: array
          description: Product media resources
          items:
            type: object
            properties:
              type:
                type: integer
                description: |
                  Media type:
                  * 1 - Image
                  * 2 - Video
                enum:
                  - 1
                  - 2
              name:
                type: string
                description: Media file name
              url:
                type: string
                description: Media file URL
              description:
                type: string
                description: Media description
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Obtain your key from the JoggAI dashboard.

````