# Google News: `POST /v1/news`

Cost: 2 credits (2 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/news

One page (up to 100) of Google News results.

This is Google's own published RSS wire — the same feed reader apps
consume — so it carries the feed's semantics: newest first, one page per
request, a `when:` freshness operator instead of a date range, and
`link` values that are Google's canonical redirects to the publisher.
`q` searches; `topic` reads a section feed; with neither the edition's
top stories answer.

Request body (JSON):

- `q` (string | null; optional; max length 200): Search query. Omit to read `topic` (or top stories).
- `topic` (string | null; optional; one of business, entertainment, health, nation, science, sports, technology, top_stories, world): Section feed: one of Google's reader sections.
- `when` (string | null; optional; pattern ^\d+[hdmy]$): Freshness window appended to `q` (`1h`, `1d`, `7d`, `1y`).
- `gl` (string; optional; default us; one of ad, ae, af, ag, ai, al, am, ao, aq, ar, as, at, au, aw, ax, az, ba, bb, bd, be, bf, bg, bh, bi, bj, bl, bm, bn, bo, bq, br, bs, bt, bv, bw, by, bz, ca, cc, cd, cf, cg, ch, ci, ck, cl, cm, cn, co, cr, cu, cv, cw, cx, cy, cz, de, dj, dk, dm, do, dz, ec, ee, eg, eh, er, es, et, fi, fj, fk, fm, fo, fr, ga, gb, gd, ge, gf, gg, gh, gi, gl, gm, gn, gp, gq, gr, gs, gt, gu, gw, gy, hk, hm, hn, hr, ht, hu, id, ie, il, im, in, io, iq, ir, is, it, je, jm, jo, jp, ke, kg, kh, ki, km, kn, kp, kr, kw, ky, kz, la, lb, lc, li, lk, lr, ls, lt, lu, lv, ly, ma, mc, md, me, mf, mg, mh, mk, ml, mm, mn, mo, mp, mq, mr, ms, mt, mu, mv, mw, mx, my, mz, na, nc, ne, nf, ng, ni, nl, no, np, nr, nu, nz, om, pa, pe, pf, pg, ph, pk, pl, pm, pn, pr, ps, pt, pw, py, qa, re, ro, rs, ru, rw, sa, sb, sc, sd, se, sg, sh, si, sj, sk, sl, sm, sn, so, sr, ss, st, sv, sx, sy, sz, tc, td, tf, tg, th, tj, tk, tl, tm, tn, to, tr, tt, tv, tw, tz, ua, ug, uk, um, us, uy, uz, va, vc, ve, vg, vi, vn, vu, wf, ws, xk, ye, yt, za, zm, zw): Country market.
- `hl` (string; optional; default en): Language.
- `ceid` (string | null; optional; pattern ^[A-Z]{2}:[a-z]{2}$): Explicit edition override (`CA:fr`, `GB:en`); built from `gl`/`hl` when omitted.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
