BlitzReels
BlitzReelsDocumentation

Stock Media

Search vetted stock image, video, and audio providers, then import assets into BlitzReels media.

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

Terminal
curl "https://www.blitzreels.com/api/v1/workspace/stock-media/search?query=keyboard%20click&asset_type=audio&provider=freesound&limit=10" \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"
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

Terminal
curl -X POST https://www.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:

Terminal
curl -X POST https://www.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

Terminal
curl -X POST https://www.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:

Terminal
curl -X POST https://www.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

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