10.1 GET /posts — list
Filters (all optional, CSV = OR within field, AND between fields):
| Param | Type | Example |
|---|---|---|
lang |
string | ?lang=tr-TR |
after / before / limit |
cursor | ?after=12345&limit=20 |
since |
ISO 8601 timestamp | ?since=2026-05-20T00:00:00Z |
category |
CSV slug | ?category=markets-etfs,defi-dexs |
ticker |
CSV uppercase | ?ticker=BTC,ETH |
hashtag |
CSV | ?hashtag=Bitcoin,DeFi |
sentiment |
CSV enum | ?sentiment=BULLISH,NEUTRAL (BULLISH/NEUTRAL/BEARISH) |
importance_min |
int 0-100 | ?importance_min=50 |
Validation: - Unknown slug/ticker → silent skip (matches nothing, no error) - Unknown sentiment enum → 422 - Invalid timestamp → 422
Example request:
curl -H "Authorization: Bearer zk_YOUR_KEY" \
"https://zippfeed.com/api/v1/developer/posts?lang=tr-TR&category=markets-etfs&importance_min=50&limit=20"
Response (lean shape per post):
{
"id": 12345,
"slug": "ethereum-quietly-setting-up-a-move-to-37004200",
"published_at": "2026-05-22T10:00:00Z",
"lang": "tr-TR",
"canonical_url": "https://zippfeed.com/tr-TR/a/<slug>",
"title": "...",
"lede": "1-2 sentence opener",
"cover_image_url": "https://cdn.zippfeed.com/...",
"categories": [
{"slug": "markets-etfs", "name": "ETF'ler"},
{"slug": "defi-dexs", "name": "DEX'ler"}
],
"importance": 75,
"sentiment": "BULLISH"
}