HubLens > API

// public api

Access HubLens trending OSS data programmatically. Free, no authentication required. Use it in your apps, scripts, dashboards, or AI tools.

// base url

https://hublens.dev/api/v1

// endpoints

GET/api/v1/trending

Today's trending OSS projects (updated daily). Returns articles from the last 30 hours, ranked by score.

Param	Type	Default	Description
limit	number	20	Results per page (max 50)
offset	number	0	Skip N results
category	string	—	Filter by category (e.g. "AI", "DevTools")
source	string	—	Filter by source ("github", "hn")

GET/api/v1/archive

Full article archive with pagination. Search across all historically tracked projects.

Param	Type	Default	Description
limit	number	50	Results per page (max 100)
offset	number	0	Skip N results
category	string	—	Filter by category
source	string	—	Filter by source
q	string	—	Search by slug or title

GET/api/v1/articles/:slug

Get full details for a specific article by its slug.

// example

# Get today's top 5 trending projects
curl "https://hublens.dev/api/v1/trending?limit=5"

# Search archive for React-related projects
curl "https://hublens.dev/api/v1/archive?q=react"

# Get details for a specific project
curl "https://hublens.dev/api/v1/articles/facebook-react"

// response format

All list endpoints return this structure:

{
  "data": [
    {
      "slug": "owner-repo",
      "title_en": "Project Title",
      "title_zh": "...",
      "summary_en": "One-paragraph summary",
      "summary_zh": "...",
      "category": "AI",
      "tags": ["machine-learning", "python"],
      "stars": 12345,
      "stars_change": 234,
      "score": 87,
      "trending_score": 45,
      "source": "github",
      "repo_url": "https://github.com/owner/repo",
      "rank_overall": 1,
      "rank_category": 1,
      "updated_at": "2026-04-19T12:00:00.000Z"
    }
  ],
  "meta": {
    "total": 15,
    "limit": 20,
    "offset": 0,
    "generated_at": "2026-04-19T12:00:00.000Z"
  }
}

// rate limits

>60 requests per hour per IP address
>Exceeding the limit returns 429 Too Many Requests
>Responses are cached for 1 hour (data updates daily)

// mcp server

Use HubLens data directly in AI tools like Claude Code. Install the MCP server to query trending projects, search the archive, and get article details from your AI assistant.

# Add to Claude Code
claude mcp add hublens -- npx -y @hublens/mcp-server

Once added, your AI assistant can use tools like hublens_trending, hublens_search, and hublens_article to access live OSS trend data.

// cors & usage

>CORS is enabled for all origins — use from any frontend or script
>No API key required (Free tier)
>Data is updated once per day via our automated pipeline