Google News Search API

Search Google News using the documented query and filters, and return structured results.

GET/v1/google_news/search

1 credit per successful callCache window 5 minutesFull API reference ↗

Coverage is rolling out during preview. Test the endpoint you need before integrating. Unavailable operations return an explicit error and use no credits.

Try this endpoint

Enter the documented inputs, run a protected browser test, and inspect the JSON response.

GET/v1/google_news/search

keywordrequiredThe keyword or phrase to look up.

Optional parameters (11)

depthoptionalProvide depth in the format shown in the example.location_codeoptionalProvide location code in the format shown in the example.location_nameoptionalProvide location name in the format shown in the example.location_coordinateoptionalProvide location coordinate in the format shown in the example.language_codeoptionalProvide language code in the format shown in the example.time_rangeoptionalProvide time range in the format shown in the example.publisheroptionalProvide publisher in the format shown in the example.fromoptionalProvide from in the format shown in the example.tooptionalProvide to in the format shown in the example.sinceoptionalProvide since in the format shown in the example.untiloptionalProvide until in the format shown in the example.

No API key needed for this protected browser test. Production calls require a server-side SocialQuery key.

Request preview

Copy this request into your server-side integration, or run a test to inspect the response.

curl -X GET 'https://socialquery.dev/v1/google_news/search?keyword=openai' \
  -H "x-api-key: $SOCIALQUERY_API_KEY"

Request contract

Parameters

Pass these fields as query parameters. Production requests also require your server-side API key.

keywordRequired: The keyword or phrase to look up.
Example: openai
depthOptional: Provide depth in the format shown in the example.
Example: 20
location_codeOptional: Provide location code in the format shown in the example.
Example: 10
location_nameOptional: Provide location name in the format shown in the example.
Example: —
location_coordinateOptional: Provide location coordinate in the format shown in the example.
Example: —
language_codeOptional: Provide language code in the format shown in the example.
Example: en
time_rangeOptional: Provide time range in the format shown in the example.
Example: day
publisherOptional: Provide publisher in the format shown in the example.
Example: bbc.com
fromOptional: Provide from in the format shown in the example.
Example: 2026-07-01
toOptional: Provide to in the format shown in the example.
Example: 2026-07-15
sinceOptional: Provide since in the format shown in the example.
Example: —
untilOptional: Provide until in the format shown in the example.
Example: —

Build a reliable integration.

Keep your key server-side

Pass your SocialQuery key in the x-api-key header. Never expose credentials in a browser bundle.

Check the response

Read success before using data. Preserve request_id when logging errors or contacting support.

Account for coverage

Test the fields you need. Provider availability varies, and unavailable operations use no credits.