InsightSocial API

Google News

Google News API reference: 11 endpoints for search, headlines, top stories, topics and publishers. Per-endpoint credit prices and cURL examples.

Google News search, headlines by section, top stories, Full Coverage stories, topics, publishers and publisher URLs.

Base path: /v1/googlenews/...

Quickstart

cURL
curl "https://api.insightsocial.app/v1/googlenews/search?query=climate" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

Endpoints

Every endpoint here has a fixed price.

Every endpoint here is beta: it returns the platform's own structure under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp), not a schema-2 entity, and its fields may change. See Beta endpoints.

EndpointCreditsWhat it returnsKey parameters
/articles/resolve20Get publisher URLs for up to ten Google News article ids. Beta.ids
/headlines20List Google News headlines grouped by section for an edition, with publisher URLs. Beta.—
/home20Get Google News home briefing articles with the edition's navigation sections. Beta.—
/publisher20List Google News publisher articles with publisher URLs, images, authors and labels. Beta.publication_id
/search20Search Google News by words, operators, edition and time window, and follow the cursor into older windows. Beta.query
/sections20List Google News sections for an edition, with their topic ids. Beta.—
/story20Get Google News Full Coverage story and articles from different outlets. Beta.story_id
/suggest20List Google News topic and publisher suggestions matching a name. Beta.query
/top-stories20List Google News top-story clusters for an edition, each with the other outlets covering it. Beta.—
/topic20List Google News topic, tab or publisher articles with publisher URLs, images, authors and Full Coverage story ids. Beta.topic_id
/topics/resolve20Get Google News topic or publisher ids matching a place, section, MID or name. Beta.—

On this page