# Pexels API: Search videos

> Finds free stock videos on Pexels by search words, with creator, duration, preview image and a direct MP4 link, in Pexels search order starting at the chosen results page.

Unofficial. Not affiliated with or endorsed by Pexels.

- Page: https://fous.com/methods/pexels.com/search-videos
- Method: `pexels.com/search_videos`, version 1
- Website: pexels.com
- Returns: description, creator, length, size, preview image, video file link, page link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Pexels search page to start from, for example 2. Default 1. |
| `query` | string | yes | `"mountain sunrise"` | What the video should show, for example city traffic at night. |
| `max_results` | integer | no | `26` | Maximum number of videos to return, for example 20. Default 20. |
| `orientation` | string | no | `"portrait"` | The video frame shape, for example portrait. One of "any", "landscape", "portrait", "square". Default "any". |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "page": 2,
  "query": "mountain sunrise",
  "max_results": 26,
  "orientation": "portrait"
}
```

Its output:

```json
{
  "videos": [
    {
      "width": 2160,
      "height": 3840,
      "length": "0:18",
      "video_id": 36974946,
      "description": "Scenic aerial shot of misty mountains at sunrise, showcasing nature's beauty.",
      "creator_name": "Sherine",
      "licence_note": "Free to use under the Pexels License",
      "length_seconds": 18,
      "video_file_link": "https://videos.pexels.com/video-files/36974946/15664489_2160_3840_60fps.mp4",
      "video_page_link": "https://www.pexels.com/video/aerial-view-of-misty-mountain-landscape-at-dawn-36974946/",
      "preview_image_link": "https://images.pexels.com/videos/36974946/pexels-photo-36974946.jpeg?auto=compress&cs=tinysrgb&w=1440",
      "creator_profile_link": "https://www.pexels.com/@sherine-197682976/"
    },
    {
      "width": 2160,
      "height": 3840,
      "length": "0:20",
      "video_id": 28956194,
      "description": "Stunning aerial view of mountains shrouded in clouds at sunrise, showcasing nature's beauty.",
      "creator_name": "Duy Nguyen",
      "licence_note": "Free to use under the Pexels License",
      "length_seconds": 20,
      "video_file_link": "https://videos.pexels.com/video-files/28956194/12527773_2160_3840_30fps.mp4",
      "video_page_link": "https://www.pexels.com/video/aerial-view-of-cloud-covered-mountains-at-sunrise-28956194/",
      "preview_image_link": "https://images.pexels.com/videos/28956194/4k-nature-aerial-cloud-mountain-clouds-28956194.jpeg?auto=compress&cs=tinysrgb&w=1440",
      "creator_profile_link": "https://www.pexels.com/@duy-nguyen-489946968/"
    },
    {
      "width": 1080,
      "height": 1920,
      "length": "0:09",
      "video_id": 15860398,
      "description": "Serene sunrise view over misty mountains and village.",
      "creator_name": "ORHAN BADUR",
      "licence_note": "Free to use under the Pexels License",
      "length_seconds": 9,
      "video_file_link": "https://videos.pexels.com/video-files/15860398/15860398-hd_1080_1920_30fps.mp4",
      "video_page_link": "https://www.pexels.com/video/the-sun-setting-over-a-mountain-15860398/",
      "preview_image_link": "https://images.pexels.com/videos/15860398/gun-dogumu-sunset-15860398.jpeg?auto=compress&cs=tinysrgb&w=1440",
      "creator_profile_link": "https://www.pexels.com/@orhan-badur-253753151/"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"pexels.com/search_videos","input":{"page":2,"query":"mountain sunrise","max_results":26,"orientation":"portrait"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find me free stock footage of ocean waves crashing on rocks at sunset, landscape orientation, with direct MP4 download links
- I need about 10 vertical clips of people jogging in a park for an Instagram Reel — show duration and who made each one
- Search Pexels for drone shots of snowy mountains, give me 30 results starting from page 3
- Get free videos of coffee being poured in a cafe, square format, including preview thumbnails and creator names
- Look up royalty-free videos on pexels.com showing busy Tokyo streets at night and list their length, resolution and MP4 file URLs

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Pexels search page to start from, for example 2."
    },
    "query": {
      "type": "string",
      "examples": [
        "city traffic at night"
      ],
      "minLength": 1,
      "description": "What the video should show, for example city traffic at night."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 80,
      "minimum": 1,
      "description": "Maximum number of videos to return, for example 20."
    },
    "orientation": {
      "enum": [
        "any",
        "landscape",
        "portrait",
        "square"
      ],
      "type": "string",
      "default": "any",
      "description": "The video frame shape, for example portrait."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "videos"
  ],
  "properties": {
    "videos": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "description",
          "creator_name",
          "creator_profile_link",
          "length",
          "width",
          "height",
          "preview_image_link",
          "video_file_link",
          "licence_note",
          "video_page_link",
          "video_id",
          "length_seconds"
        ],
        "properties": {
          "width": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Width in pixels of the selected video file."
          },
          "height": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Height in pixels of the selected video file."
          },
          "length": {
            "type": [
              "string",
              "null"
            ],
            "description": "Duration formatted as minutes and seconds, or hours, minutes and seconds."
          },
          "video_id": {
            "type": "integer",
            "description": "Pexels video ID."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Video description."
          },
          "creator_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the video creator."
          },
          "licence_note": {
            "type": "string",
            "description": "Pexels video licence note."
          },
          "length_seconds": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Video duration in seconds."
          },
          "video_file_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "Direct link to an HD 1920 × 1080 MP4, or the largest available MP4."
          },
          "video_page_link": {
            "type": "string",
            "description": "Pexels page for this video."
          },
          "preview_image_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "Video preview image link."
          },
          "creator_profile_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "Link to the creator’s Pexels profile."
          }
        },
        "additionalProperties": false
      },
      "description": "Matching videos in Pexels search order."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Pexels API: Search photos](https://fous.com/methods/pexels.com/search-photos.md): Search free stock photos on Pexels by subject, orientation, and page. Returns up to 80 photos in search order; Pexels may broaden searches with few exact matches.
- [Unsplash API: Search photos](https://fous.com/methods/unsplash.com/search-photos.md): Finds Unsplash photos matching a search phrase, in search order, optionally by shape; excludes Unsplash+ photos unless included. Each result has image links, photographer, licence and photo page.
- [Pinterest API: Search pins](https://fous.com/methods/pinterest.com/search-pins.md): Finds Pinterest pins for an idea in search order, with image, creator, board, saves and linked website. Limited to the first public search page.
- [Vimeo API: Get video details](https://fous.com/methods/vimeo.com/get-video.md): Gets a public Vimeo video's title, creator, play, like and comment counts, length, upload date, description, tags, thumbnail and link from its video link.
- [Dailymotion API: Search videos](https://fous.com/methods/dailymotion.com/search-videos.md): Searches Dailymotion videos by keywords, ordered by relevance, newest upload, or most views. Returns up to 100 public results.
- [YouTube API: List channel videos](https://fous.com/methods/youtube.com/list-channel-videos.md): Lists a YouTube channel's public videos, Shorts, or live uploads, newest first or most popular first, along with channel details. Counts and dates taken from displayed text may be approximate.
- [Wikimedia Commons API: Search free images](https://fous.com/methods/commons.wikimedia.org/search-free-images.md): Finds free-to-use Wikimedia Commons images for a topic in Commons relevance order. Each image comes with its links, creator and licence details.
- [The Verge API: Search news](https://fous.com/methods/theverge.com/search-news.md): Searches The Verge articles by keyword, with optional date filters, sorting and pagination. Only the first 100 matches from The Verge search are used.
- [All Pexels methods](https://fous.com/methods/pexels.com.md)