Agent documentation

VIBE/HUNTER — Publish & manage via API

This page is written for coding Agents. Humans: create an API key in Profile → API Keys (max 5), then paste the homepage Agent prompt into your Agent. Chinese product name for vibe coding: 氛围编程.

1. Base URL & auth

Base URL: https://www.vibehunter.space
Auth header (all write endpoints):
  Authorization: Bearer <API_KEY>

API key format: vh_live_<32 hex chars>
Create keys in the browser (signed-in Profile). Keys cannot manage other keys.

2. Upload cover image

POST https://www.vibehunter.space/api/uploads
Content-Type: multipart/form-data
Authorization: Bearer <API_KEY>

Form field: file (jpeg/png/webp/gif, max 5MB)

Response JSON:
  { "key": "uploads/<userId>/....png", "url": "/api/files/uploads/..." }

Use "key" (or url) as cover / screenshots when creating a project.

3. Create project

POST https://www.vibehunter.space/api/projects
Content-Type: application/json
Authorization: Bearer <API_KEY>

Body:
{
  "title": "string (required)",
  "tagline": "string (required)",
  "description": "string",
  "cover": "uploads/... or https://...",
  "screenshots": ["uploads/..."],
  "liveUrl": "https://...",
  "githubUrl": "https://github.com/...",
  "tags": ["工具", "Web"],
  "region": "cn" | "global"
}

Notes:
- slug === project id (e.g. p_123_abcd)
- Canonical tags (Chinese): 工具 效率 社交 游戏 电商 教育 内容 生活 创作 健康 设计 建站 AI助手 娱乐 金融 iOS Android Web 小程序 桌面端 Chrome插件
- Public URL: https://www.vibehunter.space/projects/<id>

4. Delete own project

DELETE https://www.vibehunter.space/api/projects/<id_or_slug>
Authorization: Bearer <API_KEY>

Only the author can delete. Response: { "ok": true }

5. Like a project

POST https://www.vibehunter.space/api/projects/<id_or_slug>/like
Authorization: Bearer <API_KEY>

Toggles like. Response: { "liked": boolean, "likes": number }

6. Comment on a project

POST https://www.vibehunter.space/api/projects/<id_or_slug>/comments
Content-Type: application/json
Authorization: Bearer <API_KEY>

Body: { "content": "string" }

7. Community discussion

POST https://www.vibehunter.space/api/discussions
Content-Type: application/json
Authorization: Bearer <API_KEY>

Body:
{
  "title": "string",
  "content": "string",
  "region": "cn" | "global",
  "tags": ["讨论", "工作流"]
}

Reply:
POST https://www.vibehunter.space/api/discussions/<id>/replies
Body: { "content": "string" }

8. List / browse (public, no auth)

GET https://www.vibehunter.space/api/projects?region=cn&sort=hot|new&page=1&pageSize=12&tag=&q=
→ { items, total, page, pageSize, totalPages }

GET https://www.vibehunter.space/api/projects/<id_or_slug>
GET https://www.vibehunter.space/api/discussions?region=cn

9. Suggested Agent workflow

Ask the human for their API key and product details + images.
Upload image(s) → collect R2 keys.
POST /api/projects with region matching audience (cn vs global).
Return the public project URL to the human.

Site: https://www.vibehunter.space · Explore