A public, versioned, rate-limited REST API. No key required for read access.
https://vibehub.cloudrf.xyz/api/v1The version is in the path. Breaking changes ship as /api/v2; v1 keeps working.
Read endpoints are public and need no credentials. Write access through the API is not available yet — use the web app, or the server actions if you are self-hosting.
100 requests per minute per IP, per endpoint. Search is limited to 60. Every response carries X-RateLimit-Limit and X-RateLimit-Remaining; a 429 adds Retry-After.
Successful responses wrap the payload in data. Paginated ones add meta.nextCursor — pass it back as ?cursor= to get the next page. A null cursor means you have reached the end.
{
"data": [ ... ],
"meta": { "nextCursor": "clx123abc", "hasMore": true }
}Errors use a consistent envelope:
{
"error": { "code": "not_found", "message": "No published app with slug \"foo\"." }
}/api/v1Service discovery. Lists every endpoint in this version.
/api/v1/appsPaginated list of published apps.
| Parameter | Accepts |
|---|---|
| sort | trending | newest | likes | views | featured | open-source |
| category | Category slug, e.g. ai-agents |
| tag | Tag slug |
| aiTool | AI tool slug, e.g. claude-code |
| language | Exact language name, e.g. TypeScript |
| framework | Exact framework name, e.g. Next.js |
| license | SPDX identifier, e.g. MIT |
| pricing | FREE | FREEMIUM | PAID | SUBSCRIPTION | ONE_TIME | OPEN_SOURCE |
| q | Free-text search across name, tagline, and description |
| cursor | Pagination cursor from meta.nextCursor |
| limit | 1–50, default 24 |
/api/v1/apps/{slug}Full detail for one app, including AI metadata, features, and changelog.
/api/v1/creators/{username}A creator's public profile and their published apps.
/api/v1/categoriesAll categories with live app counts.
/api/v1/searchSearch across apps, people, tags, categories, and AI tools.
| Parameter | Accepts |
|---|---|
| q | Required. The search query. |
| limit | Results per group, 1–20. Default 10. |
# The 10 top trending AI agents
curl "https://vibehub.cloudrf.xyz/api/v1/apps?sort=trending&category=ai-agents&limit=10"
# Everything built with Claude Code
curl "https://vibehub.cloudrf.xyz/api/v1/apps?aiTool=claude-code"
# Open-source apps, newest first
curl "https://vibehub.cloudrf.xyz/api/v1/apps?sort=open-source&license=MIT"
# One app in full
curl "https://vibehub.cloudrf.xyz/api/v1/apps/threadwell"
# Paginate
curl "https://vibehub.cloudrf.xyz/api/v1/apps?limit=24&cursor=clx123abc"An RSS feed of the 50 newest apps is available at /feed.xml.