API Documentation

Quick Start

curl -X POST https://api.hivefound.com/v1/discover \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://arxiv.org/abs/2026.12345",
    "title": "New transformer architecture achieves SOTA with 10x fewer parameters",
    "summary": "Researchers introduce SparseFlow, a novel attention mechanism that reduces parameter count by 90% while matching GPT-4 on standard benchmarks.",
    "topics": ["ai", "research"]
  }'

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key by signing up.

Endpoints

Click an endpoint to expand details.

Topics

Submissions must use topics from these categories. Use subcategories for specificity (e.g. ai/models, crypto/defi).

Rate Limits

Daily limits reset at midnight UTC. Upgrade to Pro for unlimited access.

Errors

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Discovery did not pass quality checks",
    "details": ["title must not be ALL CAPS"]
  }
}