Base URL
https://vibeindex.ai/api/v1Authentication
All API requests require an API key. You can provide it in one of three ways:
1. X-API-Key Header (Recommended)
X-API-Key: vibe_live_xxxxxxxxxxxxx2. Authorization Bearer Header
Authorization: Bearer vibe_live_xxxxxxxxxxxxx3. Query Parameter
?api_key=vibe_live_xxxxxxxxxxxxxEndpoints
GET
/searchSearch resources by keyword
Parameters
| Name | Type | Description |
|---|---|---|
| q | string | Search query (required) |
| type | string | Filter by type: skill, plugin, mcp, marketplace |
| limit | number | Results per page (default: 10, max: 50) |
| offset | number | Pagination offset (default: 0) |
Example
curl "https://vibeindex.ai/api/v1/search?q=git" \ -H "X-API-Key: vibe_live_xxxxxxxxxxxxx"
GET
/resourcesList resources with filtering
Parameters
| Name | Type | Description |
|---|---|---|
| type | string | Filter by type: skill, plugin, mcp, marketplace |
| tag | string | Filter by tag |
| sort | string | Sort by: stars, recent, name (default: stars) |
| limit | number | Results per page (default: 10, max: 50) |
| offset | number | Pagination offset (default: 0) |
Example
curl "https://vibeindex.ai/api/v1/resources?type=mcp&limit=20" \ -H "X-API-Key: vibe_live_xxxxxxxxxxxxx"
GET
/trendingGet trending and rising resources
Parameters
| Name | Type | Description |
|---|---|---|
| period | string | Time period: day, week, month (default: week) |
| type | string | Filter by type |
| limit | number | Number of results (default: 10, max: 20) |
GET
/installGet install command for a resource
Parameters
| Name | Type | Description |
|---|---|---|
| name | string | Resource name (required) |
| type | string | Resource type (helps find exact match) |
Example
curl "https://vibeindex.ai/api/v1/install?name=git" \ -H "X-API-Key: vibe_live_xxxxxxxxxxxxx"
Response Format
{
"success": true,
"data": [...],
"pagination": {
"limit": 10,
"offset": 0,
"total": 100
},
"usage": {
"remaining": -1,
"reset_at": "2026-02-05T00:00:00Z"
}
}Rate Limits
Rate limit information is included in response headers:
| Header | Description |
|---|---|
| X-RateLimit-Limit | Daily request limit (or "unlimited") |
| X-RateLimit-Remaining | Remaining requests today |
| X-RateLimit-Reset | When the limit resets (ISO 8601) |
Free tier: Currently unlimited requests. Rate limits will be introduced for Pro/Enterprise tiers in the future.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
| invalid_api_key | 401 | API key is missing or invalid |
| api_key_revoked | 401 | API key has been revoked |
| rate_limit_exceeded | 429 | Daily rate limit exceeded |
| not_found | 404 | Resource not found |
| missing_query | 400 | Search query parameter "q" is missing |
| missing_name | 400 | Resource name parameter is missing |
| internal_error | 500 | Internal server error |