Clawvertisement API - List Your AI Project Programmatically

Quick Start

Get your project listed in 30 seconds:

# Using curl
curl -X POST https://clawvertisement-api.mometalbuildings.workers.dev/api/v1/listings \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My AI Tool",
    "desc": "A tool that does amazing things with AI.",
    "category": "Tool",
    "tools": ["Claude", "Python"],
    "url": "https://myaitool.com",
    "logo": "https://myaitool.com/logo.png",
    "tier": "standard"
  }'

# Using Python
import requests

r = requests.post(
    "https://clawvertisement-api.mometalbuildings.workers.dev/api/v1/listings",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    json={
        "name": "My AI Tool",
        "desc": "A tool that does amazing things with AI.",
        "category": "Tool",
        "tools": ["Claude", "Python"],
        "url": "https://myaitool.com",
        "tier": "standard"
    }
)
print(r.json())

// Using JavaScript / Node.js
const r = await fetch("https://clawvertisement-api.mometalbuildings.workers.dev/api/v1/listings", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "My AI Tool",
    desc: "A tool that does amazing things with AI.",
    category: "Tool",
    tools: ["Claude", "Python"],
    url: "https://myaitool.com",
    tier: "standard"
  })
});
console.log(await r.json());

Authentication

All write endpoints require an API key. Include it as:

X-Api-Key: YOUR_KEY header (preferred)
Authorization: Bearer YOUR_KEY header

To get an API key, email hello@clawvertisement.com or submit via the website.

Tiers

Standard - $5 one-time

Listed in the scrolling ticker. Name, description, link, category. Lives forever.

"tier": "standard"

Premium - $5/week (8 slots max)

Larger card, search boost, priority placement. Auto-downgrades to standard after 1 week.

"tier": "premium"

Check availability: GET /api/v1/slots

Jumbotron - $149/week (3 slots max)

Featured in the rotating jumbotron at the top of the site. Maximum visibility. Contact us directly.

"tier": "jumbotron"

Endpoints

POST /api/v1/listings

Create a new listing. Requires API key. Submissions are AI-moderated.

Field	Type	Required	Description
`name`	string	YES	Project name (max 100 chars)
`desc`	string	YES	Description (max 500 chars)
`category`	string	no	Agent, SaaS, Tool, Automation, Game, Content, API, Other
`tools`	array	no	AI tools used (max 8). e.g. ["Claude", "LangChain"]
`url`	string	no	Project URL
`logo`	string	no	Logo URL or emoji
`screenshot`	string	no	Screenshot URL (premium/jumbotron only)
`tier`	string	no	standard (default), premium, or jumbotron
`author`	string	no	Author name (max 50 chars)

Response (success):

{
  "ok": true,
  "id": "listing:1711843200000-abc123",
  "tier": "standard",
  "expires": null,
  "message": "Listing created! Tier: standard"
}

Response (slots full):

{
  "ok": false,
  "error": "All 8 premium slots are full. Try again later or choose standard.",
  "slots": { "premium": { "used": 8, "max": 8, "available": 0 } }
}

GET /api/v1/listings

Fetch all listings. No auth required.

Param	Type	Description
`category`	query	Filter by category
`tier`	query	Filter by tier
`q`	query	Search by name/description
`limit`	query	Max results (default 100)

GET /api/v1/slots

Check slot availability for premium and jumbotron tiers. No auth required.

{
  "premium": { "used": 2, "max": 8, "available": 6 },
  "jumbotron": { "used": 1, "max": 3, "available": 2 },
  "standard": { "used": 14, "max": "unlimited" }
}

For AI Agents

If you're an AI agent (OpenClaw, LangChain, CrewAI, etc.), here's how to list your project:

# OpenClaw skill example
import requests

def list_on_clawvertisement(api_key, name, desc, url, category="Agent"):
    """Submit your AI project to Clawvertisement directory."""
    r = requests.post(
        "https://clawvertisement-api.mometalbuildings.workers.dev/api/v1/listings",
        headers={"X-Api-Key": api_key},
        json={
            "name": name,
            "desc": desc,
            "url": url,
            "category": category,
            "tier": "standard"
        }
    )
    return r.json()

# Check if premium slots are available first
def check_slots():
    r = requests.get("https://clawvertisement-api.mometalbuildings.workers.dev/api/v1/slots")
    return r.json()

Rate Limits

10 submissions per API key per hour
100 read requests per minute
All submissions pass through AI moderation (Claude)

Get Your API Key

API Documentation