> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/getting-started/pexels.md).

# Pexels photos and videos in Duaer

In Duaer: Pexels: free stock photos and videos with photographer credit and file links. One successful search uses 1 credit.
## What you get

Duaer Pexels photos and videos searches Pexels stock photos or videos and returns file links with the photographer. Duaer holds the upstream API key; you only send your Duaer key.

Pick Duaer Data → Pexels photos and videos in the node creator, or open the [data market](/getting-started/data-market.md). Related: [Pixabay images and videos](/getting-started/pixabay.md), [Wikimedia Commons media](/getting-started/commons-media.md).

## When to use it

- Find a hero photo for a landing page.
- Find a portrait stock video for a short.

## When not to use it

- Illustrations and vectors. Use [Pixabay images and videos](/getting-started/pixabay.md).
- Sound effects. Use [Freesound sound effects](/getting-started/freesound.md).

## Search on the canvas

1. Open the node creator and pick Duaer Data → Pexels photos and videos.
2. Fill Words (such as coffee shop). Optional: Type (video), Orientation (portrait).
3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

## Call the API

- GET https://api.duaer.com/v1/data/pexels?words=coffee%20shop
- Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

## Call skill

Same text as Copy skill.

```
---
name: duaer-pexels
description: >-
  Duaer Pexels photos and videos. Pexels: free stock photos and videos with photographer credit and file links.
  One successful search uses 1 Duaer credit.
---

# Duaer Pexels photos and videos

Duaer Pexels photos and videos searches Pexels stock photos or videos and returns file links with the photographer. Duaer holds the upstream API key; you only send your Duaer key.

## When to use

- Find a hero photo for a landing page.
- Find a portrait stock video for a short.

## When not to use

- Illustrations and vectors. Use https://skills.duaer.com/pixabay.md.
- Sound effects. Use https://skills.duaer.com/freesound.md.

## Call

`GET https://api.duaer.com/v1/data/pexels?words=coffee%20shop`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `words`.

- `words` — Words describing the photo or video, such as coffee shop.
- `type` — Optional. `photo` or `video`. Default `photo`.
- `orientation` — Optional. `landscape`, `portrait`, or `square`.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/pexels?words=coffee%20shop` — coffee shop photos.
- `GET https://api.duaer.com/v1/data/pexels?words=ocean&type=video&orientation=portrait` — portrait ocean videos.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `mediaType`, `pexelsId`, `width`, `height`, `durationSeconds` — photo or video and its size.
- `imageUrl`, `originalUrl`, `thumbnailUrl`, `videoUrl` — file links; videos pick an MP4 up to 1920 pixels wide.
- `author`, `authorUrl`, `averageColor`, `license` — photographer or author and the Pexels License.

Pexels asks you to credit the photographer and Pexels where you can.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/pixabay.md — Duaer Pixabay images and videos
- https://skills.duaer.com/commons-media.md — Duaer Wikimedia Commons media

```
## Questions

### How many credits does a Pexels photos and videos search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

### Do I need to credit Duaer Pexels photos and videos?

The Pexels License allows free commercial use without required credit, but crediting the photographer and Pexels is appreciated. Duaer returns the photographer and profile link.

## Related

- [Pixabay images and videos in Duaer](https://doc.duaer.com/getting-started/pixabay.md)
- [Wikimedia Commons media in Duaer](https://doc.duaer.com/getting-started/commons-media.md)