{"openapi":"3.1.0","info":{"title":"Google News API (Bowmark)","version":"e833508f87ff","description":"Headlines from every publisher at once — today's top stories as clusters, a section or a city's local news, one outlet's own coverage, and everything indexed about a subject with Google's own when: and site: operators. searchNews (the door), topStories, listTopicHeadlines, listLocalHeadlines, listPublisherHeadlines, resolveArticleUrl (the redirector-to-publisher resolver every other function's links need), listTopics (the finder for getTopicHeadlines), listStories (the finder for getFullCoverage) and getFullCoverage (every outlet reporting one story) are built; everything else is still a declared stub.\n\nEvery function Bowmark has for Google News (news.google.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/google_news/searchNews":{"post":{"operationId":"searchNews","summary":"Everything Google News has indexed about a subject, across every publisher at once — headline, publisher, publication time and the Google News link, newest first.","description":"Everything Google News has indexed about a subject, across every publisher at once — headline, publisher, publication time and the Google News link, newest first. `query` is exactly what a person would type into Google News' own search box, and Google's own operators work inside it: `when:1h`/`when:1d`/`when:7d` narrows the window, `after:YYYY-MM-DD`/`before:YYYY-MM-DD` pin an explicit date range, `site:reuters.com` pins one publisher, quotes pin a phrase and `(a OR b)` unions two subjects — measured 2026-09-15: `site:reuters.com tesla` returned 100 items of which 100 carried `<source>Reuters</source>`. This is the provider's main door: a caller holding only words gets in here. A query that matches nothing returns an empty `articles` array rather than throwing. **This feed caps around a hundred rows, newest first, with no count of its own** — a `when:` window OR an explicit `after:`/`before:` range wider than what fits is NOT silently cut: when the oldest row served does not reach the window's or range's start, the result carries `truncatedBefore` (the oldest served article's own timestamp) so a caller can tell the answer stopped short (measured 2026-09-18: `\"tesla when:7d\"` reached only its newest 11.7h; measured 2026-09-19: an 8-day `after:`/`before:` range reached only its newest ~24.5h, with over a hundred articles proven missing). **Do not paste `truncatedBefore` into `before:`** — it is a timestamp and `after:`/`before:` take a whole date in Google's own zone, so the literal value re-asks the same range forever (measured 2026-09-19: 0 rows on the exact value, or a repeating query stuck at 109 of 300 real articles). Page with the sibling field `resumeBefore` instead — a date one day earlier, guaranteed to move — until a call comes back with neither field. `locale` — `{ hl, gl, ceid }` — asks for another country/language edition, e.g. `{ hl: \"es-419\", gl: \"MX\", ceid: \"MX:es\" }` for Mexico; omitted, every field defaults to the US English edition. **Google News matches the ARTICLE TEXT, not the headline**, so a row can mention the subject only in passing under a headline about something else — measured 2026-10-15, 41 of the 100 rows for \"Patrick Collison\" never name him in the headline, the newest a syndicated column titled \"Trump\". Every row carries `headlineMatches`, the query words its headline names (`[]` for none; operators and generic words like \"pricing\" never count): keep the rows where it is non-empty when you need stories ABOUT a person or company, and when no row qualifies the run's `notes` says so.\n\nCalls `bowmark.providers.google_news.searchNews`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsSearchResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"},"locale":{"$ref":"#/components/schemas/GoogleNewsLocaleArg","description":"TypeScript: `GoogleNewsLocaleArg`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/topStories":{"post":{"operationId":"topStories","summary":"What Google News is leading with right now — the front page, as ranked story CLUSTERS rather than a flat list.","description":"What Google News is leading with right now — the front page, as ranked story CLUSTERS rather than a flat list. Each entry carries the lead headline and publisher plus every other outlet covering the same story, which is the one thing a single publisher's own feed can never give a caller asking \"what is everyone saying about this today\". `locale` — `{ hl, gl, ceid }` — asks for another country/language edition, e.g. `{ hl: \"es-419\", gl: \"MX\", ceid: \"MX:es\" }` for Mexico; omitted, the US English front page.\n\nCalls `bowmark.providers.google_news.topStories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsTopStories>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locale":{"$ref":"#/components/schemas/GoogleNewsLocaleArg","description":"TypeScript: `GoogleNewsLocaleArg`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/listTopicHeadlines":{"post":{"operationId":"listTopicHeadlines","summary":"The latest headlines in one of Google News' own eight sections — World, Nation, Business, Technology, Entertainment, Sports, Science or Health — by section NAME, so a caller who has only the word \"tec","description":"The latest headlines in one of Google News' own eight sections — World, Nation, Business, Technology, Entertainment, Sports, Science or Health — by section NAME, so a caller who has only the word \"technology\" never has to hold an opaque topic id. The name is matched case-insensitively against the closed list of eight; anything else throws before any request is made, because an unrecognized section answers 200 with Google News' own app-shell HTML rather than a 404 (measured 2026-09-15) — reading that as an empty section would be silently wrong rather than refused. `locale` — `{ hl, gl, ceid }` — asks for another country/language edition; omitted, the US English one.\n\nCalls `bowmark.providers.google_news.listTopicHeadlines`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsTopicHeadlines>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"section":{"type":"string","description":"TypeScript: `string`"},"locale":{"$ref":"#/components/schemas/GoogleNewsLocaleArg","description":"TypeScript: `GoogleNewsLocaleArg`"}},"required":["section"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/listPublisherHeadlines":{"post":{"operationId":"listPublisherHeadlines","summary":"Everything Google News has indexed from one publisher — `publisher` is a domain like \"reuters.com\" or a name like \"Reuters\" — newest first, optionally narrowed with `query` the same way `searchNews` t","description":"Everything Google News has indexed from one publisher — `publisher` is a domain like \"reuters.com\" or a name like \"Reuters\" — newest first, optionally narrowed with `query` the same way `searchNews` takes one, including its `when:`/`after:`/`before:` window operators. Built on the search door with a `site:` filter (`/rss/search?q=site:<publisher> <query>`), NOT on the route that looks like its own: `/rss/headlines/section/publication/<NAME>` answers 200 with the Top stories feed byte-for-byte for a name it cannot resolve, so it would look like it worked and be wrong for every publisher. `site:` takes a DOMAIN, so a NAME is resolved to one through the search door first (the host dominating that name's own search results) rather than passed straight to `site:`, where it is mis-parsed as a TLD plus a keyword (measured 2026-09-17: \"Al Jazeera\" returned 100 rows, all from the .al ccTLD) — a name the door cannot resolve is refused rather than answered with the wrong newsroom. Measured 2026-09-15: `site:reuters.com tesla` returned 100 items of which 100 carried a `<source>` domain on `reuters.com`. **Same truncation caveat as `searchNews`**: a `when:` window OR an explicit `after:`/`before:` range wider than the feed's ~100-row cap is never silently cut — the result carries `truncatedBefore` when more exists before that timestamp (measured 2026-09-18: `listPublisherHeadlines(\"reuters.com\", \"when:7d\")` reached only its newest 22h; measured 2026-09-19: an 8-day `after:`/`before:` range reached only its newest ~24.5h). **Do not paste `truncatedBefore` into `before:`** — page with the sibling field `resumeBefore` instead, exactly as `searchNews` does; the timestamp re-asks the same range forever. `locale` — `{ hl, gl, ceid }` — asks for another country/language edition; omitted, the US English one. **A bare call (no `query`) that comes back with zero rows is refused rather than answered with an empty list, when the domain does not resolve at all** — Google's own feed answers a nonexistent domain and a real outlet with nothing recent identically (measured 2026-09-20: `google.com`, `wikipedia.org` and `example.com` all get the same empty shape while several small real newsroom domains each got at least one row), so a resolving domain is still handed back honestly empty and only a domain with no DNS record is refused. Each row carries `headlineMatches` — the words of YOUR `query` its headline names, `[]` for none — because the feed matches article text, not headlines; see `searchNews`.\n\nCalls `bowmark.providers.google_news.listPublisherHeadlines`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsPublisherHeadlines>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string","description":"TypeScript: `string`"},"query":{"type":"string","description":"TypeScript: `string`"},"locale":{"$ref":"#/components/schemas/GoogleNewsLocaleArg","description":"TypeScript: `GoogleNewsLocaleArg`"}},"required":["publisher"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/listLocalHeadlines":{"post":{"operationId":"listLocalHeadlines","summary":"What is being reported in one place — the local-news edition for a city or region, by NAME (\"Seattle\", \"San Francisco\"), NOT a ZIP or postal code.","description":"What is being reported in one place — the local-news edition for a city or region, by NAME (\"Seattle\", \"San Francisco\"), NOT a ZIP or postal code. There is no closed list of valid places, so a place Google News has no edition for is refused only after the request comes back: it answers 200 with an in-protocol \"This feed is not available.\" sentinel item and a bare \"Google News\" channel title rather than the place's own name (measured 2026-09-15 on a nonsense place; the same sentinel `_client` already drops out of every other feed by guid) — reading that as an empty result would be silently wrong, so this throws instead. A US ZIP code gets a second, quieter version of the same failure: Google mints a place-shaped channel for it too (\"94103 - Latest - Google News\") but with zero headlines, which would otherwise read as a genuinely quiet news day — measured 2026-09-18, four dense-metro ZIPs all answered 0 while \"Seattle\" answered 70 in the same run, and every real place swept (however small) resolved to at least one headline, so a place-shaped channel with zero items is refused too, naming a city as the fix. A recognized place's own channel title is echoed back in `place`, in the site's own spelling, so `\"seattle\"` and `\"Seattle\"` both resolve to `\"Seattle\"`. `locale` — `{ hl, gl, ceid }` — asks for another country/language edition; omitted, the US English one.\n\nCalls `bowmark.providers.google_news.listLocalHeadlines`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsLocalHeadlines>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"place":{"type":"string","description":"TypeScript: `string`"},"locale":{"$ref":"#/components/schemas/GoogleNewsLocaleArg","description":"TypeScript: `GoogleNewsLocaleArg`"}},"required":["place"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/resolveArticleUrl":{"post":{"operationId":"resolveArticleUrl","summary":"The publisher's real article URL behind a Google News link — every `link` in every feed above is a `news.google.com/rss/articles/<id>` redirector that does NOT redirect (it 302s to itself, then serves","description":"The publisher's real article URL behind a Google News link — every `link` in every feed above is a `news.google.com/rss/articles/<id>` redirector that does NOT redirect (it 302s to itself, then serves an interstitial with no publisher URL anywhere in its bytes), so this is what turns a headline into something a caller can actually read. Takes either the bare `articleId` (a feed item's own `<guid>`) or a full redirector link someone pasted. Two hops, both browserless: GET the interstitial for a `data-n-a-id`/`-ts`/`-sg` signature minted for that article page, then POST it to the site's `batchexecute` RPC for the real URL — the signature cannot be skipped or reused across articles, so this is always two requests.\n\nCalls `bowmark.providers.google_news.resolveArticleUrl`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsArticleResolution>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"articleIdOrLink":{"type":"string","description":"TypeScript: `string`"}},"required":["articleIdOrLink"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/listTopics":{"post":{"operationId":"listTopics","summary":"The topics Google News' own home-page nav rail is offering today — the eight standing sections plus \"Your local news\" (measured 2026-09-15: nine entries, geo-scoped to whichever exit made the request)","description":"The topics Google News' own home-page nav rail is offering today — the eight standing sections plus \"Your local news\" (measured 2026-09-15: nine entries, geo-scoped to whichever exit made the request) — each with the opaque topic id `getTopicHeadlines` takes. Read off the home page's own embedded `AF_initDataCallback({key: 'ds:2'…})` state rather than scraped from the rendered nav, so it needs no browser. The finder that makes a topic id reachable by somebody who only holds words. The \"Your local news\" entry's id is NOT a topic feed — the site serves it by geo-locating the reader — so `getTopicHeadlines` and `listStories` both refuse it and name `listLocalHeadlines` instead. `locale` — `{ hl, gl, ceid }` — asks for another country/language edition's own nav rail; omitted, the US English one.\n\nCalls `bowmark.providers.google_news.listTopics`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsTopic[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locale":{"$ref":"#/components/schemas/GoogleNewsLocaleArg","description":"TypeScript: `GoogleNewsLocaleArg`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/getTopicHeadlines":{"post":{"operationId":"getTopicHeadlines","summary":"The headlines under any Google News topic id — the opaque key `/rss/topics/<id>` takes, which the eight named sections `listTopicHeadlines` takes by word are only a subset of.","description":"The headlines under any Google News topic id — the opaque key `/rss/topics/<id>` takes, which the eight named sections `listTopicHeadlines` takes by word are only a subset of. Identical fetch and parse to `listTopicHeadlines` (`/rss/topics/<topicId>` rather than `/rss/headlines/section/topic/<NAME>`) — the only difference is the key, since a topic id has no canonical spelling for the site to correct it to. Measured 2026-09-15: the Technology section's own topic id answers the identical feed shape as its section-name door, 70 items, titled \"Technology - Latest - Google News\". EIGHT OF THE NINE `listTopics` IDS ARE REACHABLE WITHOUT AN ACCOUNT; the ninth — \"Your local news\" — is refused before any request, since the site serves it by geo-locating the reader rather than from a topic feed (measured 2026-09-17: that id 404s here and returns zero stories from `listStories`, with no error). Call `listLocalHeadlines(\"<city>\")` for that entry instead. Google News also runs entity and interest topics (a company, a person, a sports league), but measured 2026-09-16 nothing logged-out hands their ids out — a topic page, a story page, `/home` and `/publications` each carry only the nav rail's own nine, and the HTML `/search` page that renders the entity's Follow chip answers 429 through the proxy. To follow a company or a person today, use `searchNews`. A CALLER HOLDING ONE OF THE EIGHT SECTION NAMES INSTEAD (e.g. \"Technology\") IS REFUSED BEFORE ANY REQUEST, naming `listTopicHeadlines` as the door that takes a word — measured 2026-09-19: passing a name here used to answer an HTTP 400 naming neither door. `locale` — `{ hl, gl, ceid }` — asks for another country/language edition; omitted, the US English one.\n\nCalls `bowmark.providers.google_news.getTopicHeadlines`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsTopicFeed>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","description":"TypeScript: `string`"},"locale":{"$ref":"#/components/schemas/GoogleNewsLocaleArg","description":"TypeScript: `GoogleNewsLocaleArg`"}},"required":["topicId"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/listStories":{"post":{"operationId":"listStories","summary":"The story CLUSTERS Google News is running right now, as ids — the finder for `getFullCoverage`.","description":"The story CLUSTERS Google News is running right now, as ids — the finder for `getFullCoverage`. Pass a `topicId` (from `listTopics`, or one of the eight section names' own topic id) to read a topic page — measured 2026-09-15: 43 distinct stories on the Technology topic page, the richer of the two doors — or omit it to read the front page instead, which surfaces far fewer (2 measured) since most front-page items are single-outlet. Reads the \"Full Coverage\" anchor Google News renders on every multi-outlet story directly off the page's HTML, rather than the page's own embedded state — no RSS feed on this site emits a story id at all, so this is the only door. A `topicId` from `listTopics`' \"Your local news\" entry is refused before any request — that entry is not a topic feed; call `listLocalHeadlines(\"<city>\")` instead (measured 2026-09-17: without this check the id silently answered 200 with zero stories). A `topicId` that is instead one of the eight section NAMES (e.g. \"Technology\") is likewise refused before any request, naming `listTopicHeadlines` as the door that takes a word — measured 2026-09-19: passing a name here used to answer an HTTP 400 naming neither door. `locale` — `{ hl, gl, ceid }` — asks for another country/language edition of whichever page is read; omitted, the US English one. The `storyId` each result carries has that same edition baked in, so passing it straight into `getFullCoverage` with no `locale` argument reads the right edition automatically — see `getFullCoverage`'s own note.\n\nCalls `bowmark.providers.google_news.listStories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsStory[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","description":"TypeScript: `string`"},"locale":{"$ref":"#/components/schemas/GoogleNewsLocaleArg","description":"TypeScript: `GoogleNewsLocaleArg`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/getFullCoverage":{"post":{"operationId":"getFullCoverage","summary":"Every outlet reporting one story — Google News' own Full Coverage, chained off a `storyId` from `listStories`.","description":"Every outlet reporting one story — Google News' own Full Coverage, chained off a `storyId` from `listStories`. Reads the story page's own `AF_initDataCallback({key: 'ds:0'…})` state: a mix of named groups (\"Top news\", \"Personal perspective\", an occasional \"Posts on X\" of social posts rather than articles, which are excluded) and ungrouped rows, folded into one flat list. Unlike every other function here, each article's `url` is the PUBLISHER's own page directly — no `news.google.com` redirector, so no `resolveArticleUrl` hop is needed. A story id is as short-lived as a headline; hold one only as long as the `listStories` call that produced it — a stale id throws, naming that as the likely cause, rather than answering with 0 articles. `locale` — `{ hl, gl, ceid }` — matters here even though every article already carries its own publisher URL: the STORY PAGE ITSELF is read in whichever edition is asked for, and reading it in the wrong one silently truncates or empties the coverage (measured 2026-09-16: the same story id answered 0 articles under the US default and 53 under `{ hl: \"es-419\", gl: \"MX\", ceid: \"MX:es\" }`). A `storyId` FROM `listStories` already carries the edition it was found under, so leaving `locale` unset here reads that SAME edition automatically — pass an explicit `locale` only to read a story you found some other way, and it must agree with the id's own encoded edition or the call is refused rather than silently truncated (measured live 2026-09-17: a wrong edition can render a place or topic label that reads like a real headline).\n\nCalls `bowmark.providers.google_news.getFullCoverage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsFullCoverage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string","description":"TypeScript: `string`"},"locale":{"$ref":"#/components/schemas/GoogleNewsLocaleArg","description":"TypeScript: `GoogleNewsLocaleArg`"}},"required":["storyId"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/listEditions":{"post":{"operationId":"listEditions","summary":"The country and language editions Google News publishes — the `hl`/`gl`/`ceid` triple every function above already takes — so a caller asking for Mexican or Indian coverage can name one instead of gue","description":"The country and language editions Google News publishes — the `hl`/`gl`/`ceid` triple every function above already takes — so a caller asking for Mexican or Indian coverage can name one instead of guessing at a locale code. An authFunction: the picker lives behind the signed-in account bar's own \"Language & region\" page (`news.google.com/settings`), which a logged-out request cannot reach at all — measured 2026-09-16, it 302s straight to `accounts.google.com/ServiceLogin`. Bowmark signs nobody up for a Google account; sign in with your own, exactly as `youtube`'s six `authFunctions` already work on the same Google session. With no session this refuses before returning, naming the sign-in; the `hl`/`gl`/`ceid` triple itself works with no session at all (pass it straight to `searchNews`, `topStories`, etc.) — this function only discovers the list of valid triples, never gates using one.\n\nCalls `bowmark.providers.google_news.listEditions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsEdition[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/getForYou":{"post":{"operationId":"getForYou","summary":"The personalised \"For You\" feed — what Google News picks for the signed-in caller from the topics and outlets they follow and what they have read, as story doors ready to hand to `getFullCoverage`.","description":"The personalised \"For You\" feed — what Google News picks for the signed-in caller from the topics and outlets they follow and what they have read, as story doors ready to hand to `getFullCoverage`. An authFunction, on the same Google session `listEditions` and `youtube`'s six already work on: `news.google.com/foryou` 302s straight to `accounts.google.com/ServiceLogin` for a logged-out request (measured 2026-09-26 through CRAWLER_PROXY) — Bowmark signs nobody up for a Google account; sign in with your own. The page renders the SAME story-cluster template `listStories` already reads off `/home` and `/topics/<id>`, just personalised rather than scoped to the front page or one section, so this reuses that parser rather than a second one. With no session, or a dead one, this refuses before returning anything, naming the sign-in.\n\nCalls `bowmark.providers.google_news.getForYou`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsStory[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/listFollowedTopics":{"post":{"operationId":"listFollowedTopics","summary":"The topics, places and publishers the signed-in person follows, exactly as Google News' own Following page lists them.","description":"The topics, places and publishers the signed-in person follows, exactly as Google News' own Following page lists them. An authFunction, on the same Google session `listEditions` and `getForYou` already work on: the home page's own nav rail resolves the \"Following\" tab to `news.google.com/my/library` (there is no separate `/following` route — that path 301s to the plain homepage rather than gating on sign-in, measured 2026-09-27), and a logged-out GET of `/my/library` 302s straight to `accounts.google.com/ServiceLogin`, the identical shape `listEditions` and `getForYou` measure on `/settings` and `/foryou` — Bowmark signs nobody up for a Google account; sign in with your own. With no session, or a dead one, this refuses before returning anything, naming the sign-in. **The signed-in shape is honestly UNMEASURED**, exactly as `listEditions`' is: nobody here holds a signed-in Google News session, so nobody has ever captured what `/my/library` renders for an account that follows anything.\n\nCalls `bowmark.providers.google_news.listFollowedTopics`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsFollowedTopic[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/listSavedArticles":{"post":{"operationId":"listSavedArticles","summary":"The articles the signed-in person saved for later, exactly as Google News' own Saved tab lists them.","description":"The articles the signed-in person saved for later, exactly as Google News' own Saved tab lists them. An authFunction, on the same Google session `listEditions`, `getForYou` and `listFollowedTopics` already work on. Measured 2026-09-27 through CRAWLER_PROXY: the site exposes no route for Saved distinct from Following — `/saved` and `/my/library/saved` both 301 to the plain homepage rather than gating on sign-in — so Saved is a TAB inside the same `news.google.com/my/library` door `listFollowedTopics` already reads, not a separate one, and this reuses `fetchGoogleNewsLibrary` rather than a second door. With no session, or a dead one, this refuses before returning anything, naming the sign-in. **The signed-in shape is honestly UNMEASURED**, exactly as `listFollowedTopics`' is: nobody here holds a signed-in Google News session, so nobody has ever captured which section of that page lists saved articles.\n\nCalls `bowmark.providers.google_news.listSavedArticles`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleNewsSavedArticle[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/saveArticle":{"post":{"operationId":"saveArticle","summary":"Save an article to the signed-in person's own reading list — the Google News equivalent of a bookmark, and the write half of `listSavedArticles`.","description":"Save an article to the signed-in person's own reading list — the Google News equivalent of a bookmark, and the write half of `listSavedArticles`. An authFunction, on the same Google session `listEditions`, `getForYou`, `listFollowedTopics` and `listSavedArticles` already work on. With no session, or a dead one, this refuses before returning, naming the sign-in, the same 302 to `accounts.google.com/ServiceLogin` measured 2026-09-28 through CRAWLER_PROXY. **With a session it also refuses, always** (fixed 2026-10-04): nobody here has found or captured the real \"Save\" request a signed-in click sends — the only reachable door, `/my/library`, is read-only and GETting it changes nothing — so this throws rather than reporting a save that never happened. See BUILD_QUEUE.md.\n\nCalls `bowmark.providers.google_news.saveArticle`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<void>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"articleHandle":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["articleHandle"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/google_news/followTopic":{"post":{"operationId":"followTopic","summary":"Follow a topic, a place or a publisher as the signed-in person — the write half of `listFollowedTopics`.","description":"Follow a topic, a place or a publisher as the signed-in person — the write half of `listFollowedTopics`. An authFunction, on the same Google session `listEditions`, `getForYou`, `listFollowedTopics`, `listSavedArticles` and `saveArticle` already work on. This lands on our own account's own Following list, visible to nobody else and undone by unfollowing, so it is honestly testable without touching a real person or publisher. There is no separate follow endpoint reachable to probe logged out — measured 2026-09-27: a real topic page renders a real \"Follow this topic\" button for every visitor, signed in or not, and its jsaction token names no `batchexecute` call site anywhere in the 3.7 MB document — so this reuses the SAME `/my/library` door `listFollowedTopics` and `saveArticle` already read, which refuses with the identical 302 to `accounts.google.com/ServiceLogin` measured 2026-09-28. With no session, or a dead one, this refuses before returning, naming the sign-in. **With a session it also refuses, always** (fixed 2026-10-04, same defect and fix as `saveArticle`): nobody here has found or captured the real \"Follow\" request a signed-in click sends — the only reachable door, `/my/library`, is read-only and GETting it changes nothing — so this throws rather than reporting a follow that never happened. See BUILD_QUEUE.md.\n\nCalls `bowmark.providers.google_news.followTopic`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<void>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["topicId"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}},"GoogleNewsLocaleArg":{"type":"object","properties":{"hl":{"type":"string"},"gl":{"type":"string"},"ceid":{"type":"string"}},"additionalProperties":true}}}}