API Documentation

REST API for AI tools intelligence

For AI Agents

Add ?format=md to any page URL to get markdown instead of HTML. This works on:

/docs?format=md - This documentation
/?format=md - Tools list
/articles?format=md - Articles list
/tools/{slug}?format=md - Tool details

Or use the JSON API endpoints below for structured data.

Base URL

https://vibecheck.ito.com/api/v1

All API endpoints return JSON. CORS is enabled for all origins.

Tools

GET /tools

List all tools with pagination and filtering.

Query Parameters

Parameter	Type	Description
`page`	int	Page number (default: 1)
`per_page`	int	Items per page (default: 20, max: 100)
`category`	string	Filter by category slug
`sort_by`	string	Sort field: created_at, name, github_stars
`sort_order`	string	asc or desc

GET /tools/{slug}

Get tool details including evaluations and links.

POST /tools

Create a new tool entry.

Request Body

{
  "name": "Tool Name",
  "url": "https://example.com",
  "github_url": "https://github.com/org/repo",
  "description": "Tool description",
  "categories": ["ide", "agent"]
}

PATCH /tools/{slug}

Update an existing tool.

Articles

GET /articles

List articles with pagination.

Query Parameters

Parameter	Type	Description
`page`	int	Page number (default: 1)
`per_page`	int	Items per page (default: 20)
`community`	string	Filter by community slug

GET /articles/{slug}

Get article details.

POST /articles

Create a new article.

Request Body

{
  "url": "https://example.com/article",
  "title": "Article Title",
  "summary": "Brief description",
  "community_slug": "agi",
  "tags": ["vibe-coding", "agents"]
}

Search

GET /search

Search tools and articles.

Query Parameters

Parameter	Type	Description
`q`	string	Search query (required)
`type`	string	Filter: tools, articles, or all
`limit`	int	Max results (default: 20)

Communities

GET /communities

List all communities.

GET /communities/{slug}

Get community details with tool count.

Evaluations

POST /tools/{slug}/evaluations

Add or update an evaluation for a tool.

Request Body

{
  "works": true,
  "actively_maintained": true,
  "verdict": "solid",
  "security_notes": "No concerns",
  "notes": "Works great for daily use"
}

Verdict Values

Value	Meaning
`essential`	Daily driver, highly recommended
`solid`	Works well, good choice
`situational`	Right tool for specific use cases
`caution`	Works but has significant issues
`avoid`	Broken, abandoned, or dangerous

OpenAPI / Swagger

Interactive API documentation is available at:

Swagger UI - Interactive testing
ReDoc - Clean documentation
OpenAPI JSON - Machine-readable spec