Skip to main content
ZV-DEVAPI

Zaviye · Developers

Multilingual news clusters, API-accessible.

The same pipeline that publishes the Zaviye newsroom is exposed as a commercial API. Farsi, Kurdish, Arabic, Turkish, and English-language press — ingested, clustered by embedding similarity, cross-language-matched, framing-annotated, and served as JSON. REST and MCP interfaces. Free, self-serve. No sales calls.

WHYZV
What Zaviye gives you that other news APIs don't
01

Farsi / Kurdish / Arabic / Turkish native ingestion

227 feeds across 8 languages, indexed as first-class corpora — not an afterthought. Most commercial news APIs offer English-only or bolt-on translation of English sources.

02

Cross-language clustering

Clusters are matched across corpora by embedding similarity. A story that ran in Kurdish and Turkish but not English is one cluster with three language slots, not three separate records.

03

Framing + bias annotations

Per-cluster framing analysis in each corpus, source-spectrum breakdown, state-media flags. The analysis layer runs on every cluster by default, free.

04

Coverage-gap signals

Endpoints that return clusters with high inter-corpus disparity — the stories one side filled pages on and another barely touched. A sellable primitive for media-monitoring products.

05

MCP + REST from the same data

Build a Claude integration with the MCP server today; move to REST for production traffic; same cluster store, same account, same rate bucket.

06

Same data the Zaviye newsroom publishes

No separate pipeline, no separate quality tier. What the API returns is what readers see on zaviye.news.

Shape of a call
$ curl https://zaviye.news/api/v1/feed \
    -H "Authorization: Bearer zv_live_••••" \
    --data-urlencode "lang=fa,ku,ar,he,tr,en" \
    --data-urlencode "limit=50" \
    -G

{
  "clusters": [
    {
      "id": "clu_8Q3…",
      "headline": "A regional rail corridor …",
      "article_count": 18,
      "languages": { "fa": 9, "ku": 5, "tr": 3, "ar": 1, "en": 1 },
      "blind_spot": true,
      "blind_spot_corpus": "en",
      "ai_summary_short": "…",
      "framing": { "fa": "…", "ku": "…", "tr": "…", "en": "…" },
      "sources": [ … ],
      "updated_at": "2026-04-20T09:04:12Z"
    }
  ],
  "usage": { "calls_this_period": 1243, "quota": 10000000 }
}
MCP Quickstart · Claude Desktop

Zaviye exposes a full MCP server via HTTP. Point any MCP-compatible client at the endpoint — the OAuth 2.0 + PKCE flow runs automatically.

// claude_desktop_config.json
{
  "mcpServers": {
    "zaviye": {
      "url": "https://zaviye.news/api/mcp",
      "transport": "http"
    }
  }
}

// Available tools: news_feed · cluster_detail · translate_cluster · profile

Full MCP scope — framing annotations included — on every key, free.

TIERSZV
Tiers
Self-serve · no billing

Zaviye API

Recommended
Free
Rate
10,000,000 calls / month
Window
Full historical archive
Languages
Farsi · Kurdish · Arabic · Turkish · English + framing & bias annotations
Keys
Up to 25 API keys

One tier, everything included — the full five-language cluster access, framing analysis, source-bias breakdowns, and coverage-gap signals that used to be split across paid tiers.

Includes

  • Access to /api/v1/feed, /api/v1/cluster/:id, /api/v1/search, /api/v1/archive
  • MCP endpoint via OAuth
  • Full five-language cluster access + translation pairs
  • Framing analysis and source-bias breakdowns per cluster
  • Coverage-gap signals endpoint
  • Changelog and status page
Typical buyers
  • · Claude / LLM integrations
  • · Indie developers building news-adjacent apps
  • · Media monitoring firms and research programmes
  • · Newsrooms, academic departments, translation services
Sign up — get a key
Self-serve · no billing
What no tier includes
  • Custom endpoint development
  • Private clustering on your own RSS feeds
  • White-label or co-branded editions
  • Streaming / WebSocket feeds (REST + MCP only)
  • Write endpoints (no posting to Zaviye via API)
  • GraphQL
  • Phone or video support at any tier
  • SLAs of any kind
  • Dedicated support engineers
  • Reselling per-source RSS relays

Every absence is a product decision. If you need any of the above, Zaviye is politely not the right API.

Acceptable use — the short version

What you can do

  • Build commercial products on Zaviye data, including paid end-user products
  • Display cluster data, framing analysis, and bias breakdowns in your UI
  • Cache responses within the data window of your tier
  • Train models on response data, credited to Zaviye
  • Combine Zaviye data with other sources

What you can't

  • Resell raw article URLs as if they were a feed you own
  • Ship a product that looks like a Zaviye clone (brand imitation)
  • Use Zaviye data to generate disinformation, targeted harassment, or engagement-bait content
  • Share your API key with parties outside your organisation
  • Circumvent rate limits via multi-account registration

Full policy lives at /developers/aup (coming). Keys may be revoked for policy violations with 30-day notice except for acute misuse, where revocation is immediate.

Heavy or unusual use — tell us

Building something that needs more than the free tier covers?

There's no paid tier above this one — but if you're training a model on the corpus, need archive dumps, or have a usage pattern the free quota doesn't fit, tell us and we'll work it out directly. No sales call, no invoice.