Search News

curl --request GET \
  --url https://socialquery.dev/v1/search/news \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://socialquery.dev/v1/search/news', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "items": [
      {
        "id": "<string>",
        "url": "<string>",
        "canonical_url": "<string>",
        "title": "<string>",
        "snippet": "<string>",
        "publisher": "<string>",
        "domain": "<string>",
        "image_url": "<string>",
        "published_at": "<string>",
        "published_at_precision": "exact",
        "engine": "google",
        "country": "<string>",
        "language": "<string>",
        "source_rank": 1,
        "provenance": [
          {
            "engine": "google",
            "country": "<string>",
            "language": "<string>",
            "rank": 1
          }
        ]
      }
    ],
    "returned_count": 1,
    "total": null,
    "next_cursor": null,
    "complete": false,
    "legs": [
      {
        "id": "<string>",
        "engine": "google",
        "country": "<string>",
        "language": "<string>",
        "keyword": "<string>",
        "query_source": "fallback_original",
        "depth": 55,
        "status": "ok",
        "error_code": "<string>",
        "returned_count": 1,
        "source_count": 1,
        "dropped": 1,
        "deduplicated": 1,
        "truncated": 1,
        "credits": 2
      }
    ],
    "planned_legs": 1,
    "skipped_countries": [
      "<string>"
    ],
    "deduplicated": 1,
    "dropped": 1,
    "query": "<string>",
    "planner": "original_query_only",
    "_warnings": [
      "<string>"
    ],
    "coverage_note": "<string>",
    "stories": null,
    "story_grouping": null
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

News search

Google News and Bing News search through SerpApi. Runs one original-query leg per country per engine (up to max_legs per engine), merges canonical article URLs and preserves all source provenance. No LLM angle expansion, translation, AI reranking or SSE. query_source=fallback_original is explicit. Google ISO publish timestamps are exact; Bing relative timestamps are approximate. Undated and out-of-window rows are omitted. Story judgments return null with stories_unavailable unless disabled. Google supports 35 configured editions; Bing supports 33. A country parameter selects the edition, not a geographic article filter. Results are bounded windows, not an exhaustive feed. A persistent shared 30-search allowance protects the existing free provider tier; paid capacity is not configured.

GET

news

Search News

curl --request GET \
  --url https://socialquery.dev/v1/search/news \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://socialquery.dev/v1/search/news', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "items": [
      {
        "id": "<string>",
        "url": "<string>",
        "canonical_url": "<string>",
        "title": "<string>",
        "snippet": "<string>",
        "publisher": "<string>",
        "domain": "<string>",
        "image_url": "<string>",
        "published_at": "<string>",
        "published_at_precision": "exact",
        "engine": "google",
        "country": "<string>",
        "language": "<string>",
        "source_rank": 1,
        "provenance": [
          {
            "engine": "google",
            "country": "<string>",
            "language": "<string>",
            "rank": 1
          }
        ]
      }
    ],
    "returned_count": 1,
    "total": null,
    "next_cursor": null,
    "complete": false,
    "legs": [
      {
        "id": "<string>",
        "engine": "google",
        "country": "<string>",
        "language": "<string>",
        "keyword": "<string>",
        "query_source": "fallback_original",
        "depth": 55,
        "status": "ok",
        "error_code": "<string>",
        "returned_count": 1,
        "source_count": 1,
        "dropped": 1,
        "deduplicated": 1,
        "truncated": 1,
        "credits": 2
      }
    ],
    "planned_legs": 1,
    "skipped_countries": [
      "<string>"
    ],
    "deduplicated": 1,
    "dropped": 1,
    "query": "<string>",
    "planner": "original_query_only",
    "_warnings": [
      "<string>"
    ],
    "coverage_note": "<string>",
    "stories": null,
    "story_grouping": null
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

Search Google News and Bing News using one original query per selected country and engine. For example, query=artificial intelligence&engines=google,bing&countries=US&depth=20 reserves at most 7 credits: two base, one Google leg, and at most four for twenty Bing articles. The final charge settles to actual returned work. Empty/failed legs cost zero; an entirely empty result costs zero. Cached responses, idempotent replays and failures are free. The provider configuration contains 35 Google editions and 33 Bing markets. Both engines support: US, GB, AU, CA, NZ, ZA, IN, AR, CL, MX, ES, BR, AT, DE, BE, NL, FR, CH, IT, DK, FI, NO, SE, PL, RU, TR, JP, KR, HK, TW, ID, MY, PH. Google also supports IE and SG. The country/language describes the searched edition, not detected article language or where an event happened. Only US and GB are included in this release’s live acceptance fixtures; the other configured markets are not individually certified. Each items[] row has a headline, canonical URL, publisher, optional snippet/image, publication date and engine/country provenance. Duplicate URLs are merged without losing their source records. Google ISO dates are tagged exact; Bing relative dates are tagged approximate. Undated articles are omitted rather than assigned invented dates. Google typically has fewer snippets.

depth: 10–100 in steps of ten, default ten; Bing caps at twenty.
max_legs: 1–12 per engine, default twelve; skipped countries are disclosed. No hidden pages or retries.
sort=date: newest first among the retrieved windows. relevance interleaves source ranks.
time_range: 1, 7, 30 or 365 rolling days. Explicit from/to overrides it.
publisher and exact date bounds: Google only. Publisher must be a bare domain, and subdomains match. Bounds are inclusive; date-only to includes the UTC day. Filtering is checked locally as well as in the source query.

legs[] shows every selected search’s count, status, cost and any failure. Partial success returns partial_results; all-failed requests return an uncharged error. total and next_cursor are null and complete is false because these are bounded source windows.

Query expansion, translation, AI ranking, story judgments and news SSE are not implemented. Each leg truthfully uses query_source=fallback_original; JSON includes localization_unavailable. Default story fields are null with stories_unavailable. judgments=off omits them unless group=stories is explicit. Use JSON, not an event stream.

Uses the existing SerpApi key and free account. A persistent shared 30-search verification ceiling fails closed without automatically resetting or buying capacity. Trials are not a sustained availability guarantee.

Authorizations

x-api-key

string

header

required

Headers

Cache-Control

string

Idempotency-Key

string

X-Max-Credits

integer

Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero.

Required range: x >= 0

Query Parameters

query

string

required

countries

string

CSV of 1–12 unique configured editions (default US): US, GB, AU, CA, NZ, ZA, IN, IE, SG, AR, CL, MX, ES, BR, AT, DE, BE, NL, FR, CH, IT, DK, FI, NO, SE, PL, RU, TR, JP, KR, HK, TW, ID, MY, PH. Duplicates collapse. Bing does not support IE or SG.

engines

string

CSV google (default), bing, or both. Each selected country runs one original-query leg per engine. publisher and from/to require Google only.

sort

enum<string>

relevance interleaves the source-ranked windows; date sorts their returned articles by newest timestamp. This does not request an exhaustive newest-first crawl.

Available options:

relevance,

date

time_range

enum<string>

day, week, month or year; default day. Local rolling bounds are 1/7/30/365 days. Ignored when from/to is supplied. Bing year uses a source-ranked window with local date filtering.

Available options:

day,

week,

month,

year

from

string

Inclusive publication bound, YYYY-MM-DD or Unix seconds. Whole UTC day for a date-only to. Google only. Local exact timestamp filtering follows the source date query; undated rows are excluded.

string

Inclusive publication bound, YYYY-MM-DD or Unix seconds. Whole UTC day for a date-only to. Google only. Local exact timestamp filtering follows the source date query; undated rows are excluded.

publisher

string

depth

integer

Maximum articles returned per leg, 10–100 in steps of ten; default ten. Bing caps at twenty. Source windows can contain fewer results. No hidden pagination.

Required range: 10 <= x <= 100

max_legs

integer

Cap of 1–12 country legs per engine, default twelve. Countries beyond the cap are returned in skipped_countries; no angle expansion occurs.

Required range: 1 <= x <= 12

group

enum<string>

stories requests grouping, currently unavailable. stories and story_grouping remain null with a stories_unavailable warning.

Available options:

stories

judgments

enum<string>

on (default) returns null story judgment fields and an unavailable warning. off omits them, unless group=stories is explicit.

Available options:

on,

off

Response

success

boolean

required

platform

string

required

endpoint

string

required

credits_used

integer

required

Required range: x >= 0

credits_remaining

integer | null

required

request_id

string

required

cached

boolean

required

data

object

required

The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.

Show child attributes