Videos Search

POST

/api/v1/videos

The videos search endpoint locates video files, tutorials, webinars, and hosted clip content across major video platforms and web indexes.

Returned objects include video links, channel names, video durations, upload timestamps, and position rankings.

Returned Video Properties

Each result in the videos response array contains structured media metadata:

title: Full title of the video stream or upload
link: Direct web page link to view or play the video
snippet: Text summary or excerpt from video description
duration: Video runtime duration string (e.g. "45:12", "1:24:00")
uploaded: Relative publish time string (e.g. "2 weeks ago", "3 months ago")
channel: Name of the publishing channel or creator handle
position: Numeric search engine rank position (1-based)

{
  "q": "nuxt 3 tutorial",
  "gl": "us",
  "hl": "en",
  "num": 10
}

Authorizations

X-API-KEYstringheaderrequired

Passed via request headers. Your secret API key for SerperMatrix (e.g. sm_live_...).

Body

application/json

qstringrequired

The search query keyword for locating video records (e.g. "nuxt 3 tutorial").

glstring

Geographic location country code for localized video algorithms (e.g. "us").

hlstring

Host language code (e.g. "en").

numintegerdefault: 10

Number of video entries to return (min: 1, max limit: 100).

use_cachebooleandefault: true

Retrieve cached video results if available (caches up to 1 hour).

Request

curl -X POST https://serpermatrix.com/api/v1/videos \
  -H "X-API-KEY: sm_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q":"nuxt 3 tutorial","num":2}'

{
  "searchParameters": {
    "q": "nuxt 3 tutorial",
    "num": 2,
    "type": "videos"
  },
  "videos": [
    {
      "title": "Nuxt 3 Crash Course for Beginners",
      "link": "https://example.com/videos/nuxt-3-crash-course",
      "snippet": "Learn Nuxt 3 from scratch in this full crash course for beginners.",
      "duration": "45:12",
      "position": 1
    }
  ]
}