API Reference

Base URL: https://api.feedplaza.com/v1

Authentication

All requests require an API key passed in the x-api-key header.

curl -H "x-api-key: YOUR_KEY" https://api.feedplaza.com/v1/...

Get your free key at feedplaza.com — 5,000 free calls on signup.

Endpoints

Method	Endpoint	Description
POST	/v1/auth/register	Register a new account and get an API key
GET	/v1/auth/me	Get current key info and usage stats
GET	/v1/news/:source	Get news from a source (hn, bbc, newsapi)
GET	/v1/weather/:city	Get current weather for a city
GET	/v1/crypto/:coin	Get crypto price (btc, eth, ...)
GET	/v1/forex/:pair	Get exchange rate (USD/EUR, ...)
GET	/v1/sources	List all available data sources and their status
GET	/v1/usage	Get current billing period usage

Common Parameters

Parameter	Type	Default	Description
limit	integer	20	Results per page (max 100)
page	integer	1	Page number for pagination
from	date	—	Filter results from this date (YYYY-MM-DD)
q	string	—	Keyword search (max 200 chars)

Response Format

{
  "status": "ok",
  "data": { ... },
  "meta": {
    "source": "openweathermap",
    "fetched_at": "2026-06-12T14:00:00Z",
    "count": 20,
    "credits_consumed": 1,
    "page": 1
  }
}

Error Codes

Status	Code	Meaning
401	unauthorized	Missing or invalid API key
429	rate_limited	Too many requests — slow down
402	quota_exceeded	Monthly call limit reached
422	validation_error	Invalid request parameters
503	source_unavailable	Data source temporarily down

Rate Limits

Plan	Per Minute	Per Month
Free	10	1,000
Starter	100	50,000
Pro	1,000	500,000