Stock media search returns provider results only. Import copies the selected file into your workspace media library before it can be rendered or inserted on a timeline.

Current providers:

* `pexels` for stock images and videos (`PEXELS_API_KEY` required server-side)
* `freesound` for CC0 stock audio (`FREESOUND_API_KEY` required server-side)

## Search Stock Media [#search-stock-media]

```bash title="Terminal"
curl "https://blitzreels.com/api/v1/workspace/stock-media/search?query=keyboard%20click&asset_type=audio&provider=freesound&limit=10" \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"
```

```json title="Response"
{
  "items": [
    {
      "provider": "freesound",
      "provider_asset_id": "12345",
      "asset_type": "audio",
      "title": "Keyboard click",
      "preview_url": "https://freesound.org/media/previews/12/12345_preview_hq.mp3",
      "source_url": "https://freesound.org/s/12345/",
      "license_code": "cc0",
      "requires_attribution": false,
      "duration_seconds": 1.2,
      "variants": [
        {
          "id": "preview-hq-mp3",
          "label": "High-quality MP3 preview",
          "mime_type": "audio/mpeg"
        }
      ]
    }
  ],
  "warnings": []
}
```

## Import Stock B-roll [#import-stock-b-roll]

```bash title="Terminal"
curl -X POST https://blitzreels.com/api/v1/workspace/stock-media/import \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "pexels",
    "provider_asset_id": "2499611",
    "asset_type": "video",
    "variant_id": "125004"
  }'
```

The imported image or video is marked as B-roll eligible. Insert it with the normal B-roll endpoint:

```bash title="Terminal"
curl -X POST https://blitzreels.com/api/v1/projects/{project_id}/broll \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "asset_id": "asset-uuid",
        "start_seconds": 4,
        "duration_seconds": 3,
        "position_preset": "fullscreen"
      }
    ]
  }'
```

## Import Stock Audio [#import-stock-audio]

```bash title="Terminal"
curl -X POST https://blitzreels.com/api/v1/workspace/stock-media/import \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "freesound",
    "provider_asset_id": "12345",
    "asset_type": "audio",
    "audio_type": "sound_effect"
  }'
```

Insert the imported audio with the normal audio timeline endpoint:

```bash title="Terminal"
curl -X POST https://blitzreels.com/api/v1/projects/{project_id}/timeline/audio \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "asset_id": "asset-uuid",
        "start_seconds": 4.2,
        "duration_seconds": 1.2,
        "volume": 0.8
      }
    ]
  }'
```

## CLI [#cli]

```bash title="Terminal"
blitzreels stock search --query "coffee shop" --asset-type video --provider pexels --orientation portrait --json
blitzreels stock import --provider pexels --provider-asset-id 2499611 --asset-type video --variant-id 125004
blitzreels stock search --query "keyboard click" --asset-type audio --provider freesound --json
blitzreels stock import --provider freesound --provider-asset-id 12345 --asset-type audio --audio-type sound_effect
```

## Related [#related]

* [Media Library](/docs/media-library)
* [Timeline Editing API](/docs/timeline)
* [Audio Library](/docs/audio-library)