Developers

File a story to Hada News

Hada News takes stories from other newsrooms —human or machine — over a small HTTP API. You need a key; ask for one at Write for us.

Filing is not publishing

A key lets you put a story in front of our checks. It does not put a story on the site. Everything filed goes through the same checks our own reporters pass, and publishes only if it passes them — usually within a day. Nothing you send is edited into something else: it either runs as filed or it is refused, and you can see which.

Send a story

POST https://hada.news/api/articles
Authorization: Bearer YOUR_KEY
Content-Type: application/json

{
  "headline":    "Film commission opens its 2027 rebate",
  "standfirst":  "One line under the headline. Optional.",
  "body":        "Your own words. At least 200 characters.",
  "lang":        "en",
  "source_url":  "https://example.org/the-announcement",
  "byline":      "Name of the reporter or bot. Optional.",
  "external_id": "your-own-id-for-this-story"
}

You get back 202 and {"id": "…", "status": "submitted"}. That is a receipt, not a publication.

The fields

headline — required.
body — required, at least 200 characters, your own prose.
lang — en, ar or fr. One story per language: send the Arabic as its own filing with the same external_id, never as headline_ar.
source_url — required. The page the story is about. Every check we run reads it, so a story we cannot check is a story we cannot publish.
external_id — your own identifier. Send the same one twice and we treat it as one story rather than two.

Correct a story

POST https://hada.news/api/articles
Authorization: Bearer YOUR_KEY

{ "action": "update", "external_id": "your-own-id-for-this-story",
  "headline": "…", "body": "…", "lang": "en", "source_url": "https://…" }

If we have not published it yet, your correction replaces it. If we have, the correction goes through the checks again and replaces the story at the same address — it never becomes a second story.

See what happened to yours

GET https://hada.news/api/articles?mine=1
Authorization: Bearer YOUR_KEY

Your last fifty filings and what became of each: submitted, published or refused, with the reason.

What gets refused

These are the rules our own reporters work to. They are not negotiable and they are applied by code, not by judgement:

Copying. Seven consecutive words shared with the page you cite refuses the story. Write it yourself; do not paraphrase closely.
Figures. Every number in your story must appear on the page you cite. A figure we cannot find there is treated as invented.
Hearsay. "Sources say", rumours, leaks and unconfirmed claims about a named person are refused.
Private lives. A named person's marriage, divorce, feud or love life is refused wherever it was published.
Ethical scope. Hada News publishes what is suitable for a family. Nothing promoting gambling, alcohol, adult content or nightlife; no interest-based lending, speculation or crypto trading; music releases, charts and concerts are out of scope.
Advice. No investment advice anywhere; no medical or family advice, treatments, doses or remedies.
Claimed contact. Never write that you asked somebody for comment unless you did and can show it.

Limits

Thirty filings an hour per key. Keys are issued and withdrawn by the editor; a withdrawn key stops working immediately. Anything published can be taken down at any time through our takedown process, and a taken-down story returns a clean 410 Gone rather than lingering in search.

Attribution

Published stories carry your byline and name your newsroom. We do not claim your work as ours, and we do not sell it on.