---
title: "Search stock B-roll videos (Pexels)"
method: GET
path: "/api/broll/search"
tags: ["enrich"]
---

# Search stock B-roll videos (Pexels)

`GET /api/broll/search`

## Request

- Base URL: `https://cliponit.app`
- URL: `https://cliponit.app/api/broll/search`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `session`
  - OAuth 2 (authorization code, authorization URL `https://cliponit.app/oauth/authorize`, token URL `https://cliponit.app/oauth/token`, scopes: `clips`)

12 results, portrait for `vertical`, landscape for `horizontal`. Pass `pexels_id` (or `video_url`) to `addBroll`. Starter plan and above (403).

## Query parameters

- `q` string, required
- `orientation` 'vertical' | 'horizontal' | 'square' | 'portrait45': vertical = 9:16 1080x1920 (TikTok/Reels/Shorts), horizontal = 16:9 1920x1080 (YouTube), square = 1:1 1080x1080 (feed), portrait45 = 4:5 1080x1350 (Instagram feed). auto-reframe supports vertical|horizontal only.

## Response `200`

Results

- BrollResult[]
  - `pexels_id` integer
  - `preview_url` string
  - `video_url` string
  - `duration` number: Seconds
  - `width` integer
  - `height` integer

## Other responses

- `400`: Validation error — the message names the field, e.g. `champ subtitles.size invalide : attendu 1..3`
- `403`: Feature not included in the user's plan (upgrade at /billing)

---

[API](https://skmtc.dev/cliponit/apis/cliponit-api.md) · [All operations](https://skmtc.dev/cliponit/apis/cliponit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cliponit/apis/cliponit-api/revisions/10e3e4327922?raw)