API Documentation

Public JSON endpoints. All requests use Content-Type: application/json. Rate limits apply.

POST
/api/tools/execute
Run an AI tool by slug with input fields.

Request body

{
  "toolSlug": "youtube-title-generator",
  "input": {
    "topic": "AI productivity tips",
    "tone": "engaging"
  }
}

Example response

{
  "id": "...",
  "output": "...",
  "model": "...",
  "tokensUsed": 120,
  "duration": 850
}
POST
/api/feedback
Submit tool feedback, a bug report, or a feature request.

Request body

{
  "toolSlug": "youtube-title-generator",
  "message": "Great results, could use more tone options.",
  "rating": 5,
  "type": "TOOL_FEEDBACK"
}

Example response

{
  "id": "...",
  "success": true
}
POST
/api/newsletter
Subscribe an email to the newsletter.

Request body

{
  "email": "you@example.com"
}

Example response

{
  "success": true
}
POST
/api/contact
Send a contact form message.

Request body

{
  "name": "Alex",
  "email": "alex@example.com",
  "subject": "Partnership inquiry",
  "message": "I'd love to collaborate on a tools series."
}

Example response

{
  "success": true
}

Feedback type values: BUG, FEATURE, GENERAL, TOOL_FEEDBACK.