Skip to main content
POST
/
v1
/
networks
/
browser
/
news-search
{
  "query": "Österreich",
  "countryCode": "at",
  "languageCode": "de",
  "maxResults": 10,
  "fields": [
    "title",
    "link",
    "date"
  ]
}

{
  "isCached": true,
  "cacheExpiresIn": 7195,
  "results": [
    {
      "title": "Österreich ist eines der sichersten Reiseländer der Welt",
      "link": "https://www.derstandard.at/story/3000000295211/oesterreich-ist-eines-der-sichersten-reiselaender-der-welt",
      "date": "vor 12 Stunden"
    }
    // more results...
  ]
}
AuthorAuthor: Adnan Ali
Entity Reference:
NewsSearchEntity child of SearchEntity
Example

​
Request

​
query
string
required
The search query string to be used for retrieving web search results.Restrictions:
RoleDescription
Max characters100 characters
Min characters1 character
​
maxResults
number
default:5
The maximum number of search results to return.Restrictions:
RoleDescription
Min value1
Max value10
​
countryCode
string
default:"at"
The ISO 3166-1 alpha-2 country code to tailor search results to a specific country.
​
languageCode
string
default:"de"
The ISO 639-1 language code to specify the language of the search results.
​
fields
enum
default:["title","link","date","position"]
An array specifying which fields to include in the news search results. Possible values are:
  • 'title': The title of the news article.
  • 'description': A brief description of the news article.
  • 'link': The URL link to the news article.
  • 'date': The publication date of the news article.
  • 'image': The thumbnail image URL of the news article.
  • 'position': The position of the news article in the search results.
​
cache
object
An optional object to configure caching behavior for the request. By default, caching is enabled with a TTL of 120 seconds. You can customize these settings by providing the cache object.

​
Response

​
isCached
boolean
default:true
Indicates whether the response was served from cache.
​
cacheExpiresIn
number
default:7200
The time in seconds until the cached response expires. Default is 7200 seconds (2 hours).
​
results
NewsSearchEntity[]
required
An array of news search result entities matching the search query.
{
  "query": "Österreich",
  "countryCode": "at",
  "languageCode": "de",
  "maxResults": 10,
  "fields": [
    "title",
    "link",
    "date"
  ]
}

{
  "isCached": true,
  "cacheExpiresIn": 7195,
  "results": [
    {
      "title": "Österreich ist eines der sichersten Reiseländer der Welt",
      "link": "https://www.derstandard.at/story/3000000295211/oesterreich-ist-eines-der-sichersten-reiselaender-der-welt",
      "date": "vor 12 Stunden"
    }
    // more results...
  ]
}