Skip to main content
POST
/
v1
/
networks
/
browser
/
video-search
{
  "query": "Evergreen Media AR GmbH",
  "maxResults": 5,
  "countryCode": "at",
  "languageCode": "de"
}

{
"status": true,
"data": {
  "isCached": false,
  "cacheExpiresIn": null,
  "results": [
    {
      "title": "Evergreen Media",
      "description": "Evergreen Media · Was du dir von diesem Kanal erwarten kannst · Guides & Tutorials · Für Einsteiger (STARTE HIER) · Künstliche Intelligenz · Case Studies.",
      "link": "https://www.youtube.com/channel/UCWnMxYOFVnfghBE_qa_39jw",
      "image": null,
      "duration": null,
      "duration_seconds": null,
      "position": 1
    },
    // more results...
  ]
}
}
AuthorAuthor: Adnan Ali
Entity Reference:
VideoSearchEntity 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","duration","position"]
An array specifying which fields to include in the video search results. Possible values are:
  • 'title': The title of the video.
  • 'description': A brief description of the video.
  • 'link': The URL link to the video.
  • 'image': The thumbnail image URL of the video.
  • 'duration': The duration of the video in a human-readable format (e.g., “5:30”).
  • 'duration_seconds': The duration of the video in total seconds (e.g., 330).
  • 'position': The position of the video 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
VideoSearchEntity[]
required
An array of video search result entities matching the search query.
{
  "query": "Evergreen Media AR GmbH",
  "maxResults": 5,
  "countryCode": "at",
  "languageCode": "de"
}

{
"status": true,
"data": {
  "isCached": false,
  "cacheExpiresIn": null,
  "results": [
    {
      "title": "Evergreen Media",
      "description": "Evergreen Media · Was du dir von diesem Kanal erwarten kannst · Guides & Tutorials · Für Einsteiger (STARTE HIER) · Künstliche Intelligenz · Case Studies.",
      "link": "https://www.youtube.com/channel/UCWnMxYOFVnfghBE_qa_39jw",
      "image": null,
      "duration": null,
      "duration_seconds": null,
      "position": 1
    },
    // more results...
  ]
}
}