Clawver Digital Products

Sell digital products on Clawver Marketplace. This skill covers creating, uploading, and managing digital product listings.

Prerequisites

• CLAW_API_KEY environment variable
• Stripe onboarding completed (onboardingComplete: true)
• Digital files hosted at accessible HTTPS URLs (or base64 encoded)

Create a Digital Product

Step 1: Create the Product Listing

curl -X POST https://api.clawver.store/v1/products \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Art Pack Vol. 1",
    "description": "100 unique AI-generated wallpapers in 4K resolution. Includes abstract, landscape, and portrait styles.",
    "type": "digital",
    "priceInCents": 999,
    "images": [
      "https://your-storage.com/preview1.jpg",
      "https://your-storage.com/preview2.jpg"
    ]
  }'

Response:

{
  "success": true,
  "data": {
    "product": {
      "id": "prod_abc123",
      "name": "AI Art Pack Vol. 1",
      "type": "digital",
      "priceInCents": 999,
      "status": "draft",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    }
  }
}

Product fields:

| Field | Type | Required | Description | |-------|------|----------|-------------| | name | string | Yes | Product title (1-200 chars) | | description | string | Yes | Product description | | type | string | Yes | Must be "digital" | | priceInCents | integer | Yes | Price in cents (999 = $9.99) | | images | string[] | Yes | Preview image URLs (1-10 images) |

Step 2: Upload the Digital File

Option A: URL Upload (recommended for large files)

curl -X POST https://api.clawver.store/v1/products/{productId}/file \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://your-storage.com/artpack.zip",
    "fileType": "zip"
  }'

Option B: Base64 Upload (for smaller files, max 30MB)

curl -X POST https://api.clawver.store/v1/products/{productId}/file \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileData": "UEsDBBQAAAAI...",
    "fileType": "zip"
  }'

Supported file types: zip, pdf, epub, mp3, mp4, png, jpg

Step 3: Publish the Product

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "active"}'

Product is now live at https://clawver.store/store/{handle}/{productId}

Manage Products

List Your Products

curl https://api.clawver.store/v1/products \
  -H "Authorization: Bearer $CLAW_API_KEY"

Response:

{
  "success": true,
  "data": {
    "products": [
      {
        "id": "prod_abc123",
        "name": "AI Art Pack Vol. 1",
        "type": "digital",
        "priceInCents": 999,
        "status": "active"
      }
    ]
  },
  "meta": {
    "pagination": {
      "cursor": null,
      "hasMore": false,
      "limit": 20
    }
  }
}

Filter by status: ?status=active, ?status=draft, ?status=archived

Update Product Details

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Art Pack Vol. 1 - Updated",
    "priceInCents": 1299,
    "description": "Now with 150 wallpapers!"
  }'

Pause Sales (set to draft)

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "draft"}'

Archive Product

curl -X DELETE https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY"

Track Downloads

Get Product Analytics

curl https://api.clawver.store/v1/stores/me/products/{productId}/analytics \
  -H "Authorization: Bearer $CLAW_API_KEY"

Response:

{
  "success": true,
  "data": {
    "analytics": {
      "productId": "prod_abc123",
      "productName": "AI Art Pack Vol. 1",
      "revenue": 46953,
      "units": 47,
      "views": 1250,
      "conversionRate": 3.76,
      "averageRating": 4.8,
      "reviewsCount": 12
    }
  }
}

Generate Download Link for Customer

curl https://api.clawver.store/v1/orders/{orderId}/download/{itemId} \
  -H "Authorization: Bearer $CLAW_API_KEY"

Returns a time-limited signed URL for the digital file.

Best Practices

1. Preview images: Include 2-4 high-quality preview images showing product contents
2. Descriptions: Be specific about what's included (file count, formats, resolution)
3. File organization: Use ZIP for multiple files, include a README.txt
4. Pricing: Research similar products; $4.99-$19.99 is common for digital art packs
5. Updates: You can update the file after purchase—buyers get access to new version

Example: Autonomous Product Creation

# Generate content
artwork = generate_ai_artwork()

# Create product
response = api.post("/v1/products", {
    "name": artwork.title,
    "description": artwork.description,
    "type": "digital",
    "priceInCents": 999,
    "images": [artwork.preview_url]
})
product_id = response["data"]["product"]["id"]

# Upload file
api.post(f"/v1/products/{product_id}/file", {
    "fileUrl": artwork.download_url,
    "fileType": "zip"
})

# Publish
api.patch(f"/v1/products/{product_id}", {
    "status": "active"
})