Pexels API

https://www.pexels.com/api/documentation
Admin
The Pexels API provides programmatic access to the full Pexels content library, including photos and...
Tokens:26,979
Snippets:119
Trust Score:9.6
Update:5 days ago
Show doc for...
Tokens:
Raw
### Pagination Request Example

Source: https://www.pexels.com/api/documentation

Example GET request to the curated endpoint with page and per_page parameters.

```http
GET https://api.pexels.com/v1/curated?page=2&per_page=40
```

--------------------------------

### Photo Resource JSON Example

Source: https://www.pexels.com/api/documentation

Example JSON response for a Photo resource, including all image sizes and metadata.

```json
{
  "id": 2014422,
  "width": 3024,
  "height": 3024,
  "url": "https://www.pexels.com/photo/brown-rocks-during-golden-hour-2014422/",
  "photographer": "Joey Farina",
  "photographer_url": "https://www.pexels.com/@joey",
  "photographer_id": 680589,
  "avg_color": "#978E82",
  "src": {
    "original": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg",
    "large2x": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&dpr=2&h=650&w=940",
    "large": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=650&w=940",
    "medium": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=350",
    "small": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=130",
    "portrait": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=1200&w=800",
    "landscape": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=627&w=1200",
    "tiny": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&dpr=1&fit=crop&h=200&w=280"
  },
  "liked": false,
  "alt": "Brown Rocks During Golden Hour"
}
```

--------------------------------

### Search Photos with Pexels JavaScript Client

Source: https://www.pexels.com/api/documentation

Example using the 'pexels' npm package to search for photos. Requires installing the package and using your API key.

```javascript
import { createClient } from 'pexels';

const client = createClient('YOUR_API_KEY');
const query = 'Nature';

client.photos.search({ query, per_page: 1 }).then(photos => {...});
```

--------------------------------

### Video Resource Example

Source: https://www.pexels.com/api/documentation

Example JSON representation of a Video resource, showing fields such as id, width, height, url, image, duration, user, video_files, and video_pictures.

```json
{
  "id": 1,
  "width": 1920,
  "height": 1080,
  "url": "https://www.pexels.com/video/video-1/",
  "image": "https://images.pexels.com/videos/1/pexels-photo-1.jpeg",
  "duration": 10,
  "user": {
    "id": 1,
    "name": "John Doe",
    "url": "https://www.pexels.com/@john"
  },
  "video_files": [
    {
      "id": 1,
      "quality": "hd",
      "file_type": "video/mp4",
      "width": 1920,
      "height": 1080,
      "fps": 30,
      "link": "https://player.vimeo.com/external/1.hd.mp4"
    }
  ],
  "video_pictures": [
    {
      "id": 1,
      "picture": "https://images.pexels.com/videos/1/pictures/1.jpeg",
      "nr": 1
    }
  ]
}
```

--------------------------------

### Search Photos with Pexels Ruby Client

Source: https://www.pexels.com/api/documentation

Example using the 'pexels' gem to search for photos. Requires installing the gem and using your API key.

```ruby
require "pexels"

client = Pexels::Client.new("YOUR_API_KEY")

client.photos.search("Nature", per_page: 1).each do |photo|
```

--------------------------------

### Example response for popular videos

Source: https://www.pexels.com/api/documentation

This is an example JSON response from the popular videos endpoint. It shows the structure of the response, including the videos array and pagination fields.

```json
{
  "videos": [
    {
      "id": 1448735,
      "width": 1280,
      "height": 720,
      "duration": 10,
      "url": "https://www.pexels.com/video/video-of-a-woman-wearing-a-dress-1448735/",
      "image": "https://images.pexels.com/videos/1448735/free-video-1448735.jpg?auto=compress&cs=tinysrgb&fit=crop&h=630&w=1200",
      "user": {
        "id": 123,
        "name": "John Doe",
        "url": "https://www.pexels.com/@john-doe"
      },
      "video_files": [
        {
          "id": 12345,
          "quality": "hd",
          "file_type": "video/mp4",
          "width": 1280,
          "height": 720,
          "link": "https://player.vimeo.com/external/1448735.hd.mp4?s=..."
        }
      ],
      "video_pictures": [
        {
          "id": 133237,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-1.jpg",
          "nr": 1
        },
        {
          "id": 133238,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-2.jpg",
          "nr": 2
        },
        {
          "id": 133239,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-3.jpg",
          "nr": 3
        },
        {
          "id": 133240,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-4.jpg",
          "nr": 4
        },
        {
          "id": 133241,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-5.jpg",
          "nr": 5
        },
        {
          "id": 133242,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-6.jpg",
          "nr": 6
        },
        {
          "id": 133243,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-7.jpg",
          "nr": 7
        },
        {
          "id": 133244,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-8.jpg",
          "nr": 8
        },
        {
          "id": 133245,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-9.jpg",
          "nr": 9
        },
        {
          "id": 133246,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-10.jpg",
          "nr": 10
        },
        {
          "id": 133247,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-11.jpg",
          "nr": 11
        },
        {
          "id": 133248,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-12.jpg",
          "nr": 12
        },
        {
          "id": 133249,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-13.jpg",
          "nr": 13
        },
        {
          "id": 133250,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-14.jpg",
          "nr": 14
        }
      ]
    }
  ]
}
```

--------------------------------

### Authorization with Ruby client

Source: https://www.pexels.com/api/documentation

Example of requiring the Pexels Ruby client library.

```Ruby
require "pexels"
```

--------------------------------

### Search Photos Example Response

Source: https://www.pexels.com/api/documentation

Example JSON response from the search photos endpoint, showing photo details and pagination.

```JSON
{
  "total_results": 10000,
  "page": 1,
  "per_page": 1,
  "photos": [
    {
      "id": 3573351,
      "width": 3066,
      "height": 3968,
      "url": "https://www.pexels.com/photo/trees-during-day-3573351/",
      "photographer": "Lukas Rodriguez",
      "photographer_url": "https://www.pexels.com/@lukas-rodriguez-1845331",
      "photographer_id": 1845331,
      "avg_color": "#374824",
      "src": {
        "original": "https://images.pexels.com/photos/3573351/pexels-photo-3573351.png",
        "large2x": "https://images.pexels.com/photos/3573351/pexels-photo-3573351.png?auto=compress&cs=tinysrgb&dpr=2&h=650&w=940",
        "large": "https://images.pexels.com/photos/3573351/pexels-photo-3573351.png?auto=compress&cs=tinysrgb&h=650&w=940",
        "medium": "https://images.pexels.com/photos/3573351/pexels-photo-3573351.png?auto=compress&cs=tinysrgb&h=350",
        "small": "https://images.pexels.com/photos/3573351/pexels-photo-3573351.png?auto=compress&cs=tinysrgb&h=130",
        "portrait": "https://images.pexels.com/photos/3573351/pexels-photo-3573351.png?auto=compress&cs=tinysrgb&fit=crop&h=1200&w=800",
        "landscape": "https://images.pexels.com/photos/3573351/pexels-photo-3573351.png?auto=compress&cs=tinysrgb&fit=crop&h=627&w=1200",
        "tiny": "https://images.pexels.com/photos/3573351/pexels-photo-3573351.png?auto=compress&cs=tinysrgb&dpr=1&fit=crop&h=200&w=280"
      },
      "liked": false,
      "alt": "Brown Rocks During Golden Hour"
    }
  ],
  "next_page": "https://api.pexels.com/v1/search/?page=2&per_page=1&query=nature"
}
```

--------------------------------

### Ruby (pexels) request to get a video

Source: https://www.pexels.com/api/documentation

Use the pexels Ruby client to fetch a video by ID. The example shows two equivalent methods: videos.find and videos[].

```ruby
require "pexels"

client = Pexels::Client.new("YOUR_API_KEY")

client.videos.find(2499611)
# or
client.videos[2499611]
```

--------------------------------

### JavaScript (pexels) request to get a video

Source: https://www.pexels.com/api/documentation

Use the pexels JavaScript client to fetch a video by ID. The example uses the photos.show method, but for videos you should use the appropriate method (e.g., videos.show).

```javascript
import { createClient } from 'pexels';

const client = createClient('YOUR_API_KEY');

client.photos.show({ id: 2499611 }).then(photo => {...});
```

--------------------------------

### Authorization with JavaScript client

Source: https://www.pexels.com/api/documentation

Example of initializing the Pexels JavaScript client with an API key. All requests made with the client will be authenticated.

```JavaScript
import { createClient } from 'pexels';

const client = createClient('YOUR_API_KEY');

// All requests made with the client will be authenticated
```

--------------------------------

### cURL request to get collection media

Source: https://www.pexels.com/api/documentation

Use this cURL command to fetch media from a collection. Replace YOUR_API_KEY with your actual API key. The example requests one item per page with descending sort order.

```bash
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/collections/9mp14cx?per_page=1&sort=desc"
```

--------------------------------

### Rate Limit Headers Example

Source: https://www.pexels.com/api/documentation

Shows the HTTP headers returned on successful requests indicating the monthly quota and remaining requests.

```http
X-Ratelimit-Limit: 20000
X-Ratelimit-Remaining: 19684
X-Ratelimit-Reset: 1590529646
```

--------------------------------

### .NET (PexelsDotNetSDK) request for collection media

Source: https://www.pexels.com/api/documentation

Uses the PexelsDotNetSDK to asynchronously fetch a collection. Replace YOUR_API_KEY with your key. The example requests a page size of 15.

```csharp
import PexelsDotNetSDK.Api;

var pexelsClient = new PexelsClient("YOUR_API_KEY");
var result = await pexelsClient.GetCollectionAsync(id: "9mp14cx", pageSize: 15);
```

--------------------------------

### My Collections - Example Response

Source: https://www.pexels.com/api/documentation

JSON response for the my collections endpoint, showing a collection object and pagination fields.

```json
{
  "collections": [
    {
      "id": "9mp14cx",
      "title": "Cool Cats",
      "description": null,
      "private": false,
      "media_count": 6,
      "photos_count": 5,
      "videos_count": 1
    }
  ],

  "page": 2,
  "per_page": 1,
  "total_results": 5,
  "next_page": "https://api.pexels.com/v1/collections/?page=3&per_page=1",
  "prev_page": "https://api.pexels.com/v1/collections/?page=1&per_page=1"
}
```

--------------------------------

### Linking back to Pexels with HTML

Source: https://www.pexels.com/api/documentation

HTML examples for linking back to Pexels as required by the API guidelines. Includes text link and white/black logo options.

```HTML
<a href="https://www.pexels.com">Photos provided by Pexels</a>

<!-- or show our white logo -->

<a href="https://www.pexels.com">
  <img src="https://images.pexels.com/lib/api/pexels-white.png" />
</a>

<!-- or show our black logo -->

<a href="https://www.pexels.com">
  <img src="https://images.pexels.com/lib/api/pexels.png" />
</a>
```

--------------------------------

### Authorization with curl

Source: https://www.pexels.com/api/documentation

Example of making an authenticated request to the Pexels API using curl with an Authorization header.

```Bash
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/search?query=people"
```

--------------------------------

### Search Videos with cURL

Source: https://www.pexels.com/api/documentation

Example request using cURL to search for videos with query 'nature' and per_page=1. Requires an API key.

```bash
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/videos/search?query=nature&per_page=1"
```

--------------------------------

### Linking back to a Photo with HTML

Source: https://www.pexels.com/api/documentation

HTML example for linking back to a specific photo and crediting the photographer, as required by the API guidelines.

```HTML
This <a href="https://www.pexels.com/photo/food-dinner-lunch-meal-4147875">Photo</a> was taken by <a href="https://www.pexels.com/@daria">Daria</a> on Pexels.
```

--------------------------------

### Get a Photo with .NET (PexelsDotNetSDK)

Source: https://www.pexels.com/api/documentation

Use the PexelsDotNetSDK.Api library to retrieve a photo asynchronously. Create a PexelsClient with your API key and call GetPhotoAsync with the photo ID.

```csharp
import PexelsDotNetSDK.Api;

var pexelsClient = new PexelsClient("YOUR_API_KEY");
var result = await pexelsClient.GetPhotoAsync(2014422);
```

--------------------------------

### Search Videos with Ruby (pexels gem)

Source: https://www.pexels.com/api/documentation

Example using the 'pexels' Ruby gem to search for videos. The code is incomplete; it shows the beginning of a loop over results.

```ruby
require "pexels"

client = Pexels::Client.new("YOUR_API_KEY")

client.videos.search("Nature", per_page: 1).each do |video|
```

--------------------------------

### Featured Collections - Example Response

Source: https://www.pexels.com/api/documentation

JSON response for the featured collections endpoint, showing a collection object and pagination fields.

```json
{
  "collections": [
    {
      "id": "9mp14cx",
      "title": "Cool Cats",
      "description": null,
      "private": false,
      "media_count": 6,
      "photos_count": 5,
      "videos_count": 1
    }
  ],

  "page": 2,
  "per_page": 1,
  "total_results": 5,
  "next_page": "https://api.pexels.com/v1/collections/featured/?page=3&per_page=1",
  "prev_page": "https://api.pexels.com/v1/collections/featured?page=1&per_page=1"
}
```

--------------------------------

### Example Response for GetVideoAsync

Source: https://www.pexels.com/api/documentation

JSON response returned by the Pexels API for video ID 2499611, containing video metadata, file links, and picture previews.

```json
{
  "id": 2499611,
  "width": 1080,
  "height": 1920,
  "url": "https://www.pexels.com/video/2499611/",
  "image": "https://images.pexels.com/videos/2499611/free-video-2499611.jpg?fit=crop&w=1200&h=630&auto=compress&cs=tinysrgb",
  "duration": 22,
  "user": {
    "id": 680589,
    "name": "Joey Farina",
    "url": "https://www.pexels.com/@joey"
  },
  "video_files": [
    {
      "id": 125004,
      "quality": "hd",
      "file_type": "video/mp4",
      "width": 1080,
      "height": 1920,
      "link": "https://player.vimeo.com/external/342571552.hd.mp4?s=6aa6f164de3812abadff3dde86d19f7a074a8a66&profile_id=175&oauth2_token_id=57447761"
    },
    {
      "id": 125005,
      "quality": "sd",
      "file_type": "video/mp4",
      "width": 540,
      "height": 960,
      "link": "https://player.vimeo.com/external/342571552.sd.mp4?s=e0df43853c25598dfd0ec4d3f413bce1e002deef&profile_id=165&oauth2_token_id=57447761"
    },
    {
      "id": 125006,
      "quality": "sd",
      "file_type": "video/mp4",
      "width": 240,
      "height": 426,
      "link": "https://player.vimeo.com/external/342571552.sd.mp4?s=e0df43853c25598dfd0ec4d3f413bce1e002deef&profile_id=139&oauth2_token_id=57447761"
    },
    {
      "id": 125007,
      "quality": "hd",
      "file_type": "video/mp4",
      "width": 720,
      "height": 1280,
      "link": "https://player.vimeo.com/external/342571552.hd.mp4?s=6aa6f164de3812abadff3dde86d19f7a074a8a66&profile_id=174&oauth2_token_id=57447761"
    },
    {
      "id": 125008,
      "quality": "sd",
      "file_type": "video/mp4",
      "width": 360,
      "height": 640,
      "link": "https://player.vimeo.com/external/342571552.sd.mp4?s=e0df43853c25598dfd0ec4d3f413bce1e002deef&profile_id=164&oauth2_token_id=57447761"
    },
    {
      "id": 125009,
      "quality": "hls",
      "file_type": "video/mp4",
      "width": null,
      "height": null,
      "link": "https://player.vimeo.com/external/342571552.m3u8?s=53433233e4176eead03ddd6fea04d9fb2bce6637&oauth2_token_id=57447761"
    }
  ],
  "video_pictures": [
    {
      "id": 308178,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-0.jpg",
      "nr": 0
    },
    {
      "id": 308179,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-1.jpg",
      "nr": 1
    },
    {
      "id": 308180,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-2.jpg",
      "nr": 2
    },
    {
      "id": 308181,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-3.jpg",
      "nr": 3
    },
    {
      "id": 308182,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-4.jpg",
      "nr": 4
    },
    {
      "id": 308183,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-5.jpg",
      "nr": 5
    },
    {
      "id": 308184,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-6.jpg",
      "nr": 6
    },
    {
      "id": 308185,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-7.jpg",
      "nr": 7
    },
    {
      "id": 308186,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-8.jpg",
      "nr": 8
    },
    {
      "id": 308187,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-9.jpg",
      "nr": 9
    },
    {
      "id": 308188,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-10.jpg",
      "nr": 10
    },
    {
      "id": 308189,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-11.jpg",
      "nr": 11
    },
    {
      "id": 308190,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-12.jpg",
      "nr": 12
    },
    {
      "id": 308191,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-13.jpg",
      "nr": 13
    },
    {
      "id": 308192,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-14.jpg",
      "nr": 14
    }
  ]
}
```

--------------------------------

### Search Photos with cURL (Bash)

Source: https://www.pexels.com/api/documentation

Example request using cURL to search for photos with query 'nature' and per_page=1. Requires an API key.

```bash
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/search?query=nature&per_page=1"
```

--------------------------------

### Example JSON response for video search

Source: https://www.pexels.com/api/documentation

Shows the JSON structure returned by the Pexels API for a video search, including video files and pictures.

```json
{
  "page": 1,
  "per_page": 1,
  "total_results": 20475,
  "url": "https://www.pexels.com/videos/",
  "videos": [
    {
      "id": 1448735,
      "width": 4096,
      "height": 2160,
      "url": "https://www.pexels.com/video/video-of-forest-1448735/",
      "image": "https://images.pexels.com/videos/1448735/free-video-1448735.jpg?fit=crop&w=1200&h=630&auto=compress&cs=tinysrgb",
      "duration": 32,
      "user": {
        "id": 574687,
        "name": "Ruvim Miksanskiy",
        "url": "https://www.pexels.com/@digitech"
      },
      "video_files": [
        {
          "id": 58649,
          "quality": "sd",
          "file_type": "video/mp4",
          "width": 640,
          "height": 338,
          "link": "https://player.vimeo.com/external/291648067.sd.mp4?s=7f9ee1f8ec1e5376027e4a6d1d05d5738b2fbb29&profile_id=164&oauth2_token_id=57447761"
        },
        {
          "id": 58650,
          "quality": "hd",
          "file_type": "video/mp4",
          "width": 2048,
          "height": 1080,
          "link": "https://player.vimeo.com/external/291648067.hd.mp4?s=94998971682c6a3267e4cbd19d16a7b6c720f345&profile_id=175&oauth2_token_id=57447761"
        },
        {
          "id": 58651,
          "quality": "hd",
          "file_type": "video/mp4",
          "width": 4096,
          "height": 2160,
          "link": "https://player.vimeo.com/external/291648067.hd.mp4?s=94998971682c6a3267e4cbd19d16a7b6c720f345&profile_id=172&oauth2_token_id=57447761"
        },
        {
          "id": 58652,
          "quality": "hd",
          "file_type": "video/mp4",
          "width": 1366,
          "height": 720,
          "link": "https://player.vimeo.com/external/291648067.hd.mp4?s=94998971682c6a3267e4cbd19d16a7b6c720f345&profile_id=174&oauth2_token_id=57447761"
        },
        {
          "id": 58653,
          "quality": "hd",
          "file_type": "video/mp4",
          "width": 2732,
          "height": 1440,
          "link": "https://player.vimeo.com/external/291648067.hd.mp4?s=94998971682c6a3267e4cbd19d16a7b6c720f345&profile_id=170&oauth2_token_id=57447761"
        },
        {
          "id": 58654,
          "quality": "sd",
          "file_type": "video/mp4",
          "width": 960,
          "height": 506,
          "link": "https://player.vimeo.com/external/291648067.sd.mp4?s=7f9ee1f8ec1e5376027e4a6d1d05d5738b2fbb29&profile_id=165&oauth2_token_id=57447761"
        },
        {
          "id": 58655,
          "quality": "hls",
          "file_type": "video/mp4",
          "width": null,
          "height": null,
          "link": "https://player.vimeo.com/external/291648067.m3u8?s=1210fac9d80f9b74b4a334c4fca327cde08886b2&oauth2_token_id=57447761"
        }
      ],
      "video_pictures": [
        {
          "id": 133236,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-0.jpg",
          "nr": 0
        },
        {
          "id": 133237,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-1.jpg",
          "nr": 1
        },
        {
          "id": 133238,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-2.jpg",
          "nr": 2
        },
        {
          "id": 133239,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-3.jpg",
          "nr": 3
        },
        {
          "id": 133240,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-4.jpg",
          "nr": 4
        },
        {
          "id": 133241,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-5.jpg",
          "nr": 5
        },
        {
          "id": 133242,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-6.jpg",
          "nr": 6
        },
        {
          "id": 133243,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-7.jpg",
          "nr": 7
        },
        {
          "id": 133244,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-8.jpg",
          "nr": 8
        }
      ]
    }
  ]
}
```

--------------------------------

### Example JSON response for collection media

Source: https://www.pexels.com/api/documentation

Shows the structure of a successful response, including a Photo object and a Video object with fields like id, url, src, and video_files.

```json
{
  "id": "9mp14cx",
  "media": [
    {
      "type": "Photo",
      "id": 2061057,
      "width": 4850,
      "height": 3224,
      "url": "https://www.pexels.com/photo/gray-and-white-kitten-on-white-bed-2061057/",
      "photographer": "Tranmautritam",
      "photographer_url": "https://www.pexels.com/@tranmautritam",
      "photographer_id": 8509,
      "avg_color": "#BBBEC3",
      "src": {
        "original": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg",
        "large2x": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&dpr=2&h=650&w=940",
        "large": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&h=650&w=940",
        "medium": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&h=350",
        "small": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&h=130",
        "portrait": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=1200&w=800",
        "landscape": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=627&w=1200",
        "tiny": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&dpr=1&fit=crop&h=200&w=280"
      },
      "liked": false
    },
    {
      "type": "Video",
      "id": 854982,
      "width": 1280,
      "height": 720,
      "duration": 11,
      "full_res": null,
      "tags": [],
      "url": "https://www.pexels.com/video/video-of-a-tabby-cat-854982/",
      "image": "https://images.pexels.com/videos/854982/free-video-854982.jpg?auto=compress&cs=tinysrgb&fit=crop&h=630&w=1200",
      "avg_color": null,
      "user": {
        "id": 2659,
        "name": "Pixabay",
        "url": "https://www.pexels.com/@pixabay"
      },
      "video_files": [
        {
          "id": 17755,
          "quality": "hd",
          "file_type": "video/mp4",
          "width": 1280,
          "height": 720
        }
      ]
    }
  ]
}
```

--------------------------------

### Get a Photo with JavaScript (pexels)

Source: https://www.pexels.com/api/documentation

Use the pexels JavaScript client to fetch a photo by ID. The client is created with your API key, and the show method returns a promise with the photo.

```javascript
import { createClient } from 'pexels';

const client = createClient('YOUR_API_KEY');

client.photos.show({ id: 2014422 }).then(photo => {...});
```

--------------------------------

### Ruby: Initialize Pexels Client with API Key

Source: https://www.pexels.com/api/documentation

Creates a Pexels client using the PEXELS_API_KEY environment variable or a hardcoded API key.

```ruby
# Or just set the PEXELS_API_KEY env variable and it will be picked up automatically.
Pexels::Client.new("YOUR_API_KEY")
```

--------------------------------

### C#: Initialize PexelsClient with API Key

Source: https://www.pexels.com/api/documentation

Creates a PexelsClient instance using the PexelsDotNetSDK.Api namespace.

```csharp
import PexelsDotNetSDK.Api;

var pexelsClient = new PexelsClient("YOUR_API_KEY");
```

--------------------------------

### Authentication

Source: https://www.pexels.com/api/documentation

Shows how to initialize the Pexels client with an API key, either passed directly or via the PEXELS_API_KEY environment variable.

```APIDOC
## Authentication

### Description
Initialize the Pexels client with your API key. The key can be passed directly or set as the PEXELS_API_KEY environment variable.

### Method
N/A (SDK initialization)

### Endpoint
N/A

### Parameters
- **apiKey** (string) - Required - Your Pexels API key.

### Request Example
```ruby
Pexels::Client.new("YOUR_API_KEY")
```

```csharp
var pexelsClient = new PexelsClient("YOUR_API_KEY");
```

### Response
N/A
```

--------------------------------

### Search Videos with JavaScript (pexels client)

Source: https://www.pexels.com/api/documentation

Example using the 'pexels' npm client to search for videos. Note: the code uses 'client.videoes.search' which appears to be a typo; the correct method is likely 'client.videos.search'.

```javascript
import { createClient } from 'pexels';

const client = createClient('YOUR_API_KEY');
const query = 'Nature';

client.videoes.search({ query, per_page: 1 }).then(videos => {...});
```

--------------------------------

### .NET: Fetch popular videos using PexelsDotNetSDK

Source: https://www.pexels.com/api/documentation

Use this C# code with the PexelsDotNetSDK to fetch popular videos. Replace YOUR_API_KEY with your API key. The example requests 15 videos per page.

```csharp
import PexelsDotNetSDK.Api;

var pexelsClient = new PexelsClient("YOUR_API_KEY");
var result = await pexelsClient.PopularVideosAsync(pageSize: 15);
```

--------------------------------

### GET /v1/videos/search

Source: https://www.pexels.com/api/documentation

Search for videos on Pexels by topic. Supports filtering by orientation, size, locale, and pagination.

```APIDOC
## GET /v1/videos/search

### Description
This endpoint enables you to search Pexels for any topic that you would like. For example your query could be something broad like `Nature`, `Tigers`, `People`. Or it could be something specific like `Group of people working`.

### Method
GET

### Endpoint
https://api.pexels.com/v1/videos/search

### Parameters
#### Query Parameters
- **query** (string) - Required - The search query. `Ocean`, `Tigers`, `Pears`, etc.
- **orientation** (string) - Optional - Desired video orientation. The current supported orientations are: `landscape`, `portrait` or `square`.
- **size** (string) - Optional - Minimum video size. The current supported sizes are: `large`(4K), `medium`(Full HD) or `small`(HD).
- **locale** (string) - Optional - The locale of the search you are performing. The current supported locales are: `en-US`, `pt-BR`, `es-ES`, `ca-ES`, `de-DE`, `it-IT`, `fr-FR`, `sv-SE`, `id-ID`, `pl-PL`, `ja-JP`, `zh-TW`, `zh-CN`, `ko-KR`, `th-TH`, `nl-NL`, `hu-HU`, `vi-VN`, `cs-CZ`, `da-DK`, `fi-FI`, `uk-UA`, `el-GR`, `ro-RO`, `nb-NO`, `sk-SK`, `tr-TR`, `ru-RU`.
- **page** (integer) - Optional - The page number you are requesting. `Default: 1`
- **per_page** (integer) - Optional - The number of results you are requesting per page. `Default: 15` `Max: 80`

### Response
#### Success Response (200)
- **videos** (array of `Video`) - An array of `Video` objects.
- **url** (string) - The Pexels URL for the current search query.
- **page** (integer) - The current page number.
- **per_page** (integer) - The number of results returned with each page.
- **total_results** (integer) - The total number of results for the request.
- **prev_page** (string, optional) - URL for the previous page of results, if applicable.
- **next_page** (string, optional) - URL for the next page of results, if applicable.

### Request Example
```
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/videos/search?query=nature&per_page=1"
```

### Response Example
(No explicit response example provided in the source.)
```

--------------------------------

### GET https://api.pexels.com/v1/collections/featured

Source: https://www.pexels.com/api/documentation

Retrieves all featured collections on Pexels. Supports pagination with page and per_page parameters.

```APIDOC
## GET https://api.pexels.com/v1/collections/featured

### Description
This endpoint returns all featured collections on Pexels.

### Method
GET

### Endpoint
https://api.pexels.com/v1/collections/featured

### Parameters
#### Query Parameters
- **page** (integer) - Optional - The page number you are requesting. Default: 1
- **per_page** (integer) - Optional - The number of results you are requesting per page. Default: 15, Max: 80

### Response
#### Success Response (200)
- **collections** (array of Collection) - An array of Collection objects.
- **page** (integer) - The current page number.
- **per_page** (integer) - The number of results returned with each page.
- **total_results** (integer) - The total number of results for the request.
- **prev_page** (string, optional) - URL for the previous page of results, if applicable.
- **next_page** (string, optional) - URL for the next page of results, if applicable.

#### Response Example
{
  "collections": [
    {
      "id": "9mp14cx",
      "title": "Cool Cats",
      "description": null,
      "private": false,
      "media_count": 6,
      "photos_count": 5,
      "videos_count": 1
    }
  ],
  "page": 2,
  "per_page": 1,
  "total_results": 5,
  "next_page": "https://api.pexels.com/v1/collections/featured/?page=3&per_page=1",
  "prev_page": "https://api.pexels.com/v1/collections/featured?page=1&per_page=1"
}
```

--------------------------------

### GET /v1/videos/popular

Source: https://www.pexels.com/api/documentation

Retrieves the current popular Pexels videos. Supports filtering by dimensions, duration, and pagination.

```APIDOC
## GET /v1/videos/popular

### Description
This endpoint enables you to receive the current popular Pexels videos.

### Method
GET

### Endpoint
https://api.pexels.com/v1/videos/popular

### Parameters
#### Query Parameters
- **min_width** (integer) - Optional - The minimum width in pixels of the returned videos.
- **min_height** (integer) - Optional - The minimum height in pixels of the returned videos.
- **min_duration** (integer) - Optional - The minimum duration in seconds of the returned videos.
- **max_duration** (integer) - Optional - The maximum duration in seconds of the returned videos.
- **page** (integer) - Optional - The page number you are requesting. Default: 1
- **per_page** (integer) - Optional - The number of results you are requesting per page. Default: 15, Max: 80

### Response
#### Success Response (200)
- **videos** (array of Video) - An array of Video objects.
- **url** (string) - The Pexels URL for the current page.
- **page** (integer) - The current page number.
- **per_page** (integer) - The number of results returned with each page.
- **total_results** (integer) - The total number of results for the request.
- **prev_page** (string, optional) - URL for the previous page of results, if applicable.
- **next_page** (string, optional) - URL for the next page of results, if applicable.

#### Response Example
```json
{
  "videos": [
    {
      "id": 1448735,
      "width": 1920,
      "height": 1080,
      "duration": 10,
      "url": "https://www.pexels.com/video/...",
      "image": "https://images.pexels.com/videos/1448735/pictures/preview-0.jpg",
      "user": {
        "id": 1,
        "name": "John Doe",
        "url": "https://www.pexels.com/@john-doe"
      },
      "video_files": [
        {
          "id": 1,
          "quality": "hd",
          "file_type": "video/mp4",
          "width": 1920,
          "height": 1080,
          "link": "https://player.vimeo.com/external/..."
        }
      ],
      "video_pictures": [
        {
          "id": 133238,
          "picture": "https://static-videos.pexels.com/videos/1448735/pictures/preview-0.jpg",
          "nr": 0
        }
      ]
    }
  ],
  "url": "https://api.pexels.com/v1/videos/popular?per_page=1",
  "page": 1,
  "per_page": 1,
  "total_results": 1000,
  "prev_page": null,
  "next_page": "https://api.pexels.com/v1/videos/popular?page=2&per_page=1"
}
```

```
Tokens:
Raw