Skip to main content
POST
https://api.evergreens.ai
/
v1
/
networks
/
browser
/
web-search
{
  "query": "Evergreen Media AR GmbH",
  "maxResults": 5,
  "countryCode": "at",
  "languageCode": "de",
  "fields": ["title", "url", "position"]
}
{
  "status": true,
  "data": {
    "isCached": false,
    "cacheExpiresIn": null,
    "results": [
      {
        "title": "Evergreen Media® - Von Beratung zu digitalem Wachstum",
        "url": "https://www.evergreen.media/",
        "position": 1
      },
      // more results...
    ]
  }
}
Entity Reference:
WebSearchEntity 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","url","position"]
An array specifying which fields to include in the search results. Possible values are:
  • 'title': The title of the web page.
  • 'url': The URL of the web page.
  • 'description': A brief description of the web page.
  • 'position': The position of the web page 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
WebSearchEntity[]
required
An array of web search result entities matching the search query.
{
  "query": "Evergreen Media AR GmbH",
  "maxResults": 5,
  "countryCode": "at",
  "languageCode": "de",
  "fields": ["title", "url", "position"]
}
{
  "status": true,
  "data": {
    "isCached": false,
    "cacheExpiresIn": null,
    "results": [
      {
        "title": "Evergreen Media® - Von Beratung zu digitalem Wachstum",
        "url": "https://www.evergreen.media/",
        "position": 1
      },
      // more results...
    ]
  }
}