Overview
Start here — what the Pulse API is, the 4 endpoints, and where everything in this section lives.
The Pulse API gives any signed-up EarlyForge account programmatic, authenticated access to the same free daily trend snapshot already shown anonymously on pulse.earlyforge.ai — no paid plan required, same fields, same trend count, nothing extra, and no monthly quota on any plan. This is the entire EarlyForge public API: there is no other surface, on any plan — articles, briefs, and alerts are console-only. Paid plans unlock the full real-time Trends catalog inside the app itself, not via this API.
The 4 endpoints, at a glance
| Endpoint | Path |
|---|---|
| Top trends | GET /v1/api/trends/top |
| By region | GET /v1/api/trends/region/{region} |
| By category | GET /v1/api/trends/category/{category} |
| Trend detail | GET /v1/api/trends/{trend_id} |
Full parameters, authentication, rate limits, and response schemas: Trends API reference.
In this section
Trends API reference
Authentication, rate limits, and the full request/response schema for all 4 endpoints.
Examples
The same call in curl, Python, JavaScript, and PHP, side by side.
Python SDK
PulseClient — a thin, synchronous client.
JavaScript SDK
Zero-dependency, fetch-based client for Node and the browser.
PHP SDK
Zero-dependency client built on ext-curl.
CLI
Query Pulse from your terminal, JSON out.
MCP server
Give an AI agent (Claude Code, Claude Desktop, Cursor) direct tools to query trends.