🦞Clawget/Docs

Listings API

Create, read, update, and manage skill listings programmatically

Listings API

Manage your skill listings programmatically with the Clawget Listings API.

Endpoints

List All Listings

Get all public skill listings.

http
GET /v1/listings

Query parameters:

| Parameter | Type | Description | |-----------|------|-------------| | category | string | Filter by category | | search | string | Search query | | page | number | Page number (default: 1) | | limit | number | Results per page (max: 100) |

Example:

bash
curl "https://api.clawget.io/v1/listings?category=productivity&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

json
{
  "listings": [
    {
      "id": "lst_abc123",
      "name": "Email Intelligence",
      "description": "Advanced email management for agents",
      "price": 15,
      "currency": "USD",
      "category": "productivity",
      "creator": {
        "id": "usr_xyz789",
        "name": "Sarah"
      },
      "stats": {
        "sales": 312,
        "rating": 4.8,
        "reviews": 45
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 156,
    "pages": 16
  }
}

Get Listing Details

http
GET /v1/listings/:id

Example:

bash
curl https://api.clawget.io/v1/listings/lst_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Create Listing

Create a new skill listing (requires creator account).

http
POST /v1/listings

Request body:

json
{
  "name": "My Awesome Skill",
  "description": "Does amazing things",
  "longDescription": "Full markdown description...",
  "price": 20,
  "currency": "USD",
  "category": "productivity",
  "tags": ["automation", "email"],
  "installUrl": "https://github.com/you/skill",
  "documentationUrl": "https://docs.example.com"
}

Response:

json
{
  "id": "lst_new123",
  "status": "pending_review",
  "message": "Listing submitted for review. Typically approved within 24 hours."
}

Update Listing

http
PATCH /v1/listings/:id

Example:

bash
curl -X PATCH https://api.clawget.io/v1/listings/lst_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price": 25, "description": "Updated description"}'

Delete Listing

http
DELETE /v1/listings/:id

Categories

Available categories:

  • productivity - Email, calendar, tasks
  • automation - Home, workflows, integrations
  • creative - Image, video, audio generation
  • data - APIs, scraping, processing
  • communication - Messaging, social media
  • development - Dev tools, CI/CD, deployment
  • analytics - Tracking, reporting, insights
  • security - Auth, encryption, monitoring

Validation

All listings must pass validation:

✅ Required fields:

  • Name (3-50 characters)
  • Description (10-200 characters)
  • Price (> $1 USD)
  • Category (valid category)
  • Install URL (valid HTTPS URL)

⚠️ Optional but recommended:

  • Documentation URL
  • Tags (up to 5)
  • Screenshots/demo video

Next Steps

← Back to docsEdit this page →