Skip to main content
Perform a news search (batch support)
curl --request POST \
  --url http://api.serping.io/news \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "q": "<string>",
  "country": "us",
  "city": "<string>",
  "language": "en",
  "time_range": "<string>",
  "num": 10,
  "page": 1
}
'
{
  "searchParameters": {
    "q": "<string>",
    "country": "us",
    "language": "en",
    "page": 1,
    "type": "<string>",
    "autocorrect": true
  },
  "organic": [
    {
      "title": "<string>",
      "link": "<string>",
      "snippet": "<string>",
      "sitelinks": [
        {
          "title": "<string>",
          "link": "<string>"
        }
      ],
      "position": 123,
      "attributes": {},
      "date": "<string>"
    }
  ],
  "knowledgeGraph": {
    "title": "<string>",
    "type": "<string>",
    "website": "<string>",
    "imageUrl": "<string>",
    "description": "<string>",
    "descriptionSource": "<string>",
    "descriptionLink": "<string>",
    "attributes": {}
  },
  "peopleAlsoAsk": [
    {
      "question": "<string>",
      "snippet": "<string>",
      "title": "<string>",
      "link": "<string>"
    }
  ],
  "relatedSearches": [
    {
      "query": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

News search request payload. It can be a single object or an array of objects for mini batch requests.

q
string
required

Query text.

Example:

"apple inc"

country
string
default:us

ISO Country code. Defaults to 'us' if not provided.

Example:

"us"

city
string

City location. Retrieve available cities from the /city_list endpoint.

Example:

"San Francisco"

language
string
default:en

Language code. Defaults to 'en' if not provided.

Example:

"en"

time_range
string

Time range filter. Allowed values: 'h' (past hour), 'd' (past day), 'w' (past week), 'm' (past month), 'y' (past year).

Example:

"d"

num
integer
default:10

Number of results to return. Allowed values: 10, 20, 30, 50, 100. Defaults to 10.

Example:

10

page
integer
default:1

Page number of the results. Defaults to 1.

Example:

1

Response

Successful news search response

searchParameters
object
required
organic
object[]
required

List of organic search results.

knowledgeGraph
object

Additional information from the knowledge graph, if available.

peopleAlsoAsk
object[]

List of related questions.

List of related search queries.