Pexels-API
Use this guide to set up the Pexels-API source connector and review its reference information.
Prerequisites
This connector requires an API key. You can generate one free with a Gmail account at https://www.pexels.com/api/new/. Enter the generated API key and any optional parameters to establish the connection.
Setup guide
Step 1: Set up your Pexels-API connection
- Generate an API key, for example, 12345.
- Params, if you need specific information.
- Available params:
- query: Ocean, Tigers, Pears, etc. The default is people.
- orientation: landscape, portrait or square. The default is landscape.
- size: large, medium or small. The default is large.
- color: red, orange, yellow, green, turquoise, blue, violet, pink, brown, black, grey, white or any hexadecimal colour code.
- locale: 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. The default is en-US.
Step 2: Set up the Pexels-APIs connector in Airbyte
Airbyte Cloud
- Have a Log into your Airbyte Cloud account.
- In the left navigation bar, click Sources. Then, click +new source in the top-right corner.
- On the Set up the source page, enter a name for the Pexels-API connector.
- Select Pexels-API from the Source type dropdown, then enter your
api_key. - If needed, enter the params configuration. Supported params are: query, orientation, size, color, locale, collection_id
video_id, photo_id - Click Set up source.
Airbyte OSS
- Open the Airbyte Open Source dashboard.
- Enter a name for your source.
- Enter your
api_key. - If needed, enter the params configuration. Supported params are: query, orientation, size, color, locale, collection_id
video_id, photo_id - Click Set up source.
Supported sync modes
The Pexels-API source connector supports these sync modes:
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental Sync | No |
| Replicate Incremental Deletes | No |
| SSL connection | Yes |
| Namespaces | No |
Supported streams
- photos_search
- photos_curated
- videos_search
- videos_popular
- collection_featured
API method example
GET https://api.pexels.com/v1/curated?per_page=1
Performance considerations
The Pexels-API [API reference]https://www.pexels.com/api/documentation) currently covers v1. v2 is in development. The connector uses v1 by default.
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.2.50 | 2026-11-03 | 90920 | Replace single-child CompositeErrorHandler wrappers with their DefaultErrorHandler; no behavior change. |
| 0.2.49 | 2026-11-10 | 91655 | Update dependencies |
| 0.2.48 | 2026-11-03 | 90693 | Update dependencies |
| 0.2.47 | 2026-10-27 | 90035 | Update dependencies |
| 0.2.46 | 2026-10-20 | 89342 | Update dependencies |
| 0.2.45 | 2026-10-13 | 88748 | Update dependencies |
| 0.2.44 | 2026-10-06 | 87983 | Update dependencies |
| 0.2.43 | 2026-09-29 | 87304 | Update dependencies |
| 0.2.42 | 2026-09-22 | 78868 | Update dependencies |
| 0.2.41 | 2025-11-25 | 69993 | Update dependencies |
| 0.2.40 | 2025-11-18 | 69635 | Update dependencies |
| 0.2.39 | 2025-10-29 | 68954 | Update dependencies |
| 0.2.38 | 2025-10-21 | 68267 | Update dependencies |
| 0.2.37 | 2025-10-14 | 67825 | Update dependencies |
| 0.2.36 | 2025-10-07 | 67496 | Update dependencies |
| 0.2.35 | 2025-10-01 | 66963 | Update dependencies |
| 0.2.34 | 2025-09-23 | 66413 | Update dependencies |
| 0.2.33 | 2025-09-09 | 65882 | Update dependencies |
| 0.2.32 | 2025-08-23 | 65221 | Update dependencies |
| 0.2.31 | 2025-08-09 | 64735 | Update dependencies |
| 0.2.30 | 2025-08-02 | 64217 | Update dependencies |
| 0.2.29 | 2025-07-26 | 63827 | Update dependencies |
| 0.2.28 | 2025-07-19 | 63420 | Update dependencies |
| 0.2.27 | 2025-07-12 | 63234 | Update dependencies |
| 0.2.26 | 2025-07-05 | 62577 | Update dependencies |
| 0.2.25 | 2025-06-28 | 62363 | Update dependencies |
| 0.2.24 | 2025-06-21 | 61933 | Update dependencies |
| 0.2.23 | 2025-06-14 | 60548 | Update dependencies |
| 0.2.22 | 2025-05-10 | 60094 | Update dependencies |
| 0.2.21 | 2025-05-04 | 59049 | Update dependencies |
| 0.2.20 | 2025-04-19 | 58479 | Update dependencies |
| 0.2.19 | 2025-04-12 | 57851 | Update dependencies |
| 0.2.18 | 2025-04-05 | 57350 | Update dependencies |
| 0.2.17 | 2025-03-29 | 56794 | Update dependencies |
| 0.2.16 | 2025-03-22 | 56201 | Update dependencies |
| 0.2.15 | 2025-03-08 | 55543 | Update dependencies |
| 0.2.14 | 2025-03-01 | 55034 | Update dependencies |
| 0.2.13 | 2025-02-23 | 54572 | Update dependencies |
| 0.2.12 | 2025-02-15 | 53990 | Update dependencies |
| 0.2.11 | 2025-02-08 | 53477 | Update dependencies |
| 0.2.10 | 2025-02-01 | 52990 | Update dependencies |
| 0.2.9 | 2025-01-25 | 52533 | Update dependencies |
| 0.2.8 | 2025-01-18 | 51923 | Update dependencies |
| 0.2.7 | 2025-01-11 | 51374 | Update dependencies |
| 0.2.6 | 2024-12-28 | 50680 | Update dependencies |
| 0.2.5 | 2024-12-21 | 50274 | Update dependencies |
| 0.2.4 | 2024-12-14 | 49708 | Update dependencies |
| 0.2.3 | 2024-12-12 | 49324 | Update dependencies |
| 0.2.2 | 2024-12-11 | 47678 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 0.2.1 | 2024-08-16 | 44196 | Bump source-declarative-manifest version |
| 0.2.0 | 2024-08-15 | 44097 | Refactor connector to manifest-only format |
| 0.1.14 | 2024-08-12 | 43817 | Update dependencies |
| 0.1.13 | 2024-08-03 | 43057 | Update dependencies |
| 0.1.12 | 2024-07-27 | 42767 | Update dependencies |
| 0.1.11 | 2024-07-20 | 42204 | Update dependencies |
| 0.1.10 | 2024-07-15 | 38930 | Make compatible with builder |
| 0.1.9 | 2024-07-13 | 41932 | Update dependencies |
| 0.1.8 | 2024-07-10 | 41349 | Update dependencies |
| 0.1.7 | 2024-07-09 | 41077 | Update dependencies |
| 0.1.6 | 2024-07-06 | 40946 | Update dependencies |
| 0.1.5 | 2024-06-25 | 40490 | Update dependencies |
| 0.1.4 | 2024-06-22 | 39971 | Update dependencies |
| 0.1.3 | 2024-06-06 | 39216 | [autopull] Upgrade base image to v1.2.2 |
| 0.1.2 | 2024-05-21 | 38458 | [autopull] base image + poetry + up_to_date |
| 0.1.1 | 2024-05-21 | 38458 | [autopull] base image + poetry + up_to_date |
| 0.1.0 | 2022-11-02 | Init | Initial commit |