Documentation

Get on the wire in two minutes.

Three steps from nothing to a real response — the first one takes about ten seconds.
Zero setup

Try a real request right now.

No signup, no key to copy — click below for a temporary key (15 minutes, 20 calls) and a live response from /v1/news.

Live response
Click "Run a live request" to fetch 3 real, current articles from /v1/news — using a temporary demo key issued on the spot.

Create an account

Sign up with an email and password — no card required. You're provisioned instantly on a 14-day Premium trial (50,000 calls/month, 300 requests/minute, real-time stream, whale tracking, live price WebSocket) and your key is shown once, right on the confirmation page. Store it immediately; we only ever keep a hash, so it can't be shown to you again. After the trial you move automatically to the Free plan (500 calls/month) — nothing to cancel. Need more volume? Basic, Standard, Premium, and Enterprise tiers are on the pricing page — and if you need more than one vertical, the All Access bundle is cheaper than buying each Premium tier separately.

Authenticate your first request

Every content endpoint accepts either header — pick whichever fits your HTTP client better.

x-api-key: YOUR_API_KEY # — or — Authorization: Bearer YOUR_API_KEY

Make the call

Every response follows the same shape: a data array plus total/limit/offset for paginated lists.

Request
curl "https://free-api.news/v1/news?ticker=BTC&limit=1" \ -H "x-api-key: YOUR_API_KEY"
Reference

Rate limits, quotas, and errors.

Every response header and status code documented below is real — pulled directly from the API's own middleware, not simplified for marketing.

Rate limits & quota

X-RateLimit-LimitPer-minute cap for your plan
X-RateLimit-RemainingCalls left in the current minute
X-Quota-LimitMonthly call cap for your plan
X-Quota-UsedCalls used this billing period
429Rate limit exceeded — back off and retry shortly
402Monthly quota exhausted

Error shape

Every intentional error returns a stable code field — safe to branch on in code, not just the human-readable message.

{ "message": "Article not found", "code": "NOT_FOUND" }

Full interactive reference

All 37 endpoints, every parameter, every response shape — live, browsable, and testable with your own key.

Open the API reference →