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

bash

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:

json

{
  "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)

bash

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)

bash

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

bash

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

bash

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

Response:

json

{
  "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

bash

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)

bash

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

bash

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

Track Downloads

Get Product Analytics

bash

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

Response:

json

{
  "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

bash

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

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

Example: Autonomous Product Creation

python

# 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"
})