---
type: "firecrawl-provider"
description: "Openly licensed audio (sound effects, music, recordings) from Openverse's anonymous API across Freesound, Jamendo and Wikimedia Commons: search with licence, commercial-use, source, category and length filters, read one item with its licence object, attribution text and file URLs, list related audio and list the sources with counts. Returns URLs only, never audio bytes."
use_when: "Openly licensed audio (sound effects, music, recordings) from Openverse's anonymous API across Freesound, Jamendo and Wikimedia Commons: search with licence, commercial-use, source, category and length filters, read one item with its licence object, attribution text and file URLs, list related audio and list the sources with counts. Returns URLs only, never audio bytes."
categories: "Entertainment"
capabilities: 4
credits_per_call: 5
---
# Openverse on Firecrawl Alexandria

Openly licensed audio (sound effects, music, recordings) from Openverse's anonymous API across Freesound, Jamendo and Wikimedia Commons: search with licence, commercial-use, source, category and length filters, read one item with its licence object, attribution text and file URLs, list related audio and list the sources with counts. Returns URLs only, never audio bytes.

- Categories: Entertainment
- Category index: [Entertainment category](https://firecrawl.dev/alexandria/agents/categories/entertainment)
- Provider key: `openverse-org`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/openverse-org)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/openverse-org/openapi.json)

## Capabilities

- [Get audio](https://firecrawl.dev/alexandria/agents/providers/openverse-org/audio-assets/get_audio): One Openverse audio item by id or page URL: title, creator and creator URL, licence object (code, version, deed URL, commercial_use, modification_allowed, attribution_required), attribution text, source collection and source page URL, duration in seconds, format, file size, sample rate and bit rate when known, the original upload's format, category, genres, tags, album or pack, and preview/download URLs where linking is allowed. Never downloads the audio.
- [List sources](https://firecrawl.dev/alexandria/agents/providers/openverse-org/audio-assets/list_sources): The audio collections Openverse indexes (source name, display name, home URL) with the number of items from each, largest first.
- [Related audio](https://firecrawl.dev/alexandria/agents/providers/openverse-org/audio-assets/related_audio): Audio Openverse considers similar to one item (by id or page URL), usually about 10 results, each in the same shape as search_audio results with licence, attribution and URLs.
- [Search audio](https://firecrawl.dev/alexandria/agents/providers/openverse-org/audio-assets/search_audio): Search Openverse's openly licensed audio by keyword. Filters by licence, commercial use, modification, source collection (freesound, jamendo, wikimedia_audio), category, length bucket and file type; pages with continuation (anonymous access: up to 20 per page and 240 results deep). Every result carries title, creator, a licence object with commercial_use and attribution_required, ready-to-paste attribution, duration in seconds, format, sample rate when known, tags, the source page URL and a preview URL. Accepts an Openverse audio search URL.

## 1. Choose this provider when

Openly licensed audio (sound effects, music, recordings) from Openverse's anonymous API across Freesound, Jamendo and Wikimedia Commons: search with licence, commercial-use, source, category and length filters, read one item with its licence object, attribution text and file URLs, list related audio and list the sources with counts. Returns URLs only, never audio bytes.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "openverse-org",
  "capability": "audio-assets/get_audio",
  "options": {
    "id": "eab8a6e2-0ac8-4615-9e0d-ebde30523783"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `id` (string): Openverse audio UUID, e.g. eab8a6e2-0ac8-4615-9e0d-ebde30523783. Example: `<id>`
- `url` (string): An openverse.org/audio/<id> page or api.openverse.org/v1/audio/<id>/ URL, used when id is absent. Example: `<url>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "openverse-org",
    capability: "audio-assets/get_audio",
    options: {
      id: "eab8a6e2-0ac8-4615-9e0d-ebde30523783",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "openverse-org",
  "capability": "audio-assets/get_audio",
  "options": {
    "id": "eab8a6e2-0ac8-4615-9e0d-ebde30523783"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "openverse-org",
    "capability": "audio-assets/get_audio",
    "options": {
      "id": "eab8a6e2-0ac8-4615-9e0d-ebde30523783"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'openverse-org/audio-assets/get_audio' \
  --options '{"id":"eab8a6e2-0ac8-4615-9e0d-ebde30523783"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "openverse-org",
  "capability": "audio-assets/get_audio",
  "options": {
    "id": "eab8a6e2-0ac8-4615-9e0d-ebde30523783"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "openverse-org",
  "capability": "audio-assets/get_audio",
  "options": {
    "id": "eab8a6e2-0ac8-4615-9e0d-ebde30523783"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "attribution": "\"Deep Whoosh #1\" by Kinoton is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
  "audio_set": {
    "title": "Transitions",
    "url": "https://freesound.org/apiv2/packs/19970/"
  },
  "bit_rate": 128000,
  "category": null,
  "creator": {
    "name": "Kinoton",
    "url": "https://freesound.org/people/Kinoton"
  },
  "credit": "Made using Openverse; not endorsed or certified by Openverse.",
  "download_url": null,
  "duration_seconds": 3.16,
  "filesize_bytes": 69196,
  "format": "mp3",
  "genres": [],
  "id": "eab8a6e2-0ac8-4615-9e0d-ebde30523783",
  "indexed_at": "2024-05-21T15:00:07.873258Z",
  "license": {
    "attribution_required": false,
    "code": "cc0",
    "commercial_use": true,
    "modification_allowed": true,
    "name": "CC0 1.0",
    "url": "https://creativecommons.org/publicdomain/zero/1.0/",
    "version": "1.0"
  },
  "mature": false,
  "observed_at_ms": 1793743200000,
  "openverse_url": "https://openverse.org/audio/eab8a6e2-0ac8-4615-9e0d-ebde30523783",
  "original": {
    "bit_rate": null,
    "filesize_bytes": 841236,
    "format": "wav",
    "sample_rate": 44100
  },
  "page_url": "https://freesound.org/people/Kinoton/sounds/351256",
  "preview_url": "https://cdn.freesound.org/previews/351/351256_2247456-hq.mp3",
  "provider": "freesound",
  "sample_rate": null,
  "source": "freesound",
  "source_url": "https://api.openverse.org/v1/audio/eab8a6e2-0ac8-4615-9e0d-ebde30523783/",
  "tags": [
    "air",
    "sfx",
    "sound-design",
    "soundeffect",
    "sweeping",
    "swish",
    "swoosh",
    "swosh",
    "transition",
    "whoosh",
    "wind"
  ],
  "title": "Deep Whoosh #1"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Get audio

- Capability: `audio-assets/get_audio`
- Description: One Openverse audio item by id or page URL: title, creator and creator URL, licence object (code, version, deed URL, commercial_use, modification_allowed, attribution_required), attribution text, source collection and source page URL, duration in seconds, format, file size, sample rate and bit rate when known, the original upload's format, category, genres, tags, album or pack, and preview/download URLs where linking is allowed. Never downloads the audio.
- Instructions: Check the licence and attribution of a chosen sound before using it, or get its playable URL and source page.
- Cost: 5 credits per call
- Capability file: [Get audio](https://firecrawl.dev/alexandria/agents/providers/openverse-org/audio-assets/get_audio)

Accepted options:
- `id` (string): Openverse audio UUID, e.g. eab8a6e2-0ac8-4615-9e0d-ebde30523783. Example: `<id>`
- `url` (string): An openverse.org/audio/<id> page or api.openverse.org/v1/audio/<id>/ URL, used when id is absent. Example: `<url>`

Response schema example:
```json
{
  "attribution": "\"Deep Whoosh #1\" by Kinoton is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
  "audio_set": {
    "title": "Transitions",
    "url": "https://freesound.org/apiv2/packs/19970/"
  },
  "bit_rate": 128000,
  "category": null,
  "creator": {
    "name": "Kinoton",
    "url": "https://freesound.org/people/Kinoton"
  },
  "credit": "Made using Openverse; not endorsed or certified by Openverse.",
  "download_url": null,
  "duration_seconds": 3.16,
  "filesize_bytes": 69196,
  "format": "mp3",
  "genres": [],
  "id": "eab8a6e2-0ac8-4615-9e0d-ebde30523783",
  "indexed_at": "2024-05-21T15:00:07.873258Z",
  "license": {
    "attribution_required": false,
    "code": "cc0",
    "commercial_use": true,
    "modification_allowed": true,
    "name": "CC0 1.0",
    "url": "https://creativecommons.org/publicdomain/zero/1.0/",
    "version": "1.0"
  },
  "mature": false,
  "observed_at_ms": 1793743200000,
  "openverse_url": "https://openverse.org/audio/eab8a6e2-0ac8-4615-9e0d-ebde30523783",
  "original": {
    "bit_rate": null,
    "filesize_bytes": 841236,
    "format": "wav",
    "sample_rate": 44100
  },
  "page_url": "https://freesound.org/people/Kinoton/sounds/351256",
  "preview_url": "https://cdn.freesound.org/previews/351/351256_2247456-hq.mp3",
  "provider": "freesound",
  "sample_rate": null,
  "source": "freesound",
  "source_url": "https://api.openverse.org/v1/audio/eab8a6e2-0ac8-4615-9e0d-ebde30523783/",
  "tags": [
    "air",
    "sfx",
    "sound-design",
    "soundeffect",
    "sweeping",
    "swish",
    "swoosh",
    "swosh",
    "transition",
    "whoosh",
    "wind"
  ],
  "title": "Deep Whoosh #1"
}
```

### List sources

- Capability: `audio-assets/list_sources`
- Description: The audio collections Openverse indexes (source name, display name, home URL) with the number of items from each, largest first.
- Instructions: Pick values for search_audio's source filter, or see how much audio each collection contributes.
- Cost: 5 credits per call
- Capability file: [List sources](https://firecrawl.dev/alexandria/agents/providers/openverse-org/audio-assets/list_sources)

Accepted options:

Response schema example:
```json
{
  "count": 3,
  "credit": "Made using Openverse; not endorsed or certified by Openverse.",
  "observed_at_ms": 1793743200000,
  "source_url": "https://api.openverse.org/v1/audio/stats/",
  "sources": [
    {
      "audio_count": 3986828,
      "display_name": "Wikimedia Commons",
      "name": "wikimedia_audio",
      "url": "https://commons.wikimedia.org/wiki/Main_Page"
    },
    {
      "audio_count": 644709,
      "display_name": "Jamendo",
      "name": "jamendo",
      "url": "https://www.jamendo.com/start"
    },
    {
      "audio_count": 591898,
      "display_name": "Freesound",
      "name": "freesound",
      "url": "https://freesound.org/"
    }
  ],
  "total_audio": 5223435
}
```

### Related audio

- Capability: `audio-assets/related_audio`
- Description: Audio Openverse considers similar to one item (by id or page URL), usually about 10 results, each in the same shape as search_audio results with licence, attribution and URLs.
- Instructions: Find more sounds like one you already picked, e.g. other whooshes from the same pack or with similar tags.
- Cost: 5 credits per call
- Capability file: [Related audio](https://firecrawl.dev/alexandria/agents/providers/openverse-org/audio-assets/related_audio)

Accepted options:
- `id` (string): Openverse audio UUID, e.g. eab8a6e2-0ac8-4615-9e0d-ebde30523783. Example: `<id>`
- `url` (string): An openverse.org/audio/<id> page or api.openverse.org/v1/audio/<id>/ URL, used when id is absent. Example: `<url>`

Response schema example:
```json
{
  "count": 10,
  "credit": "Made using Openverse; not endorsed or certified by Openverse.",
  "id": "eab8a6e2-0ac8-4615-9e0d-ebde30523783",
  "observed_at_ms": 1793743200000,
  "results": [
    {
      "attribution": "\"Sfx Whoosh Deep Vent 1 5.wav\" by Sheyvan is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Whoosh",
        "url": "https://freesound.org/apiv2/packs/31928/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "Sheyvan",
        "url": "https://freesound.org/people/Sheyvan"
      },
      "download_url": null,
      "duration_seconds": 3.23,
      "filesize_bytes": 72384,
      "format": "mp3",
      "genres": [],
      "id": "3d674de7-e515-41a2-bc28-592bf91dab8a",
      "indexed_at": "2022-06-01T12:00:12.608809Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/3d674de7-e515-41a2-bc28-592bf91dab8a",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 466196,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/Sheyvan/sounds/569422",
      "preview_url": "https://cdn.freesound.org/previews/569/569422_3248005-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "Deep",
        "Sfx",
        "Vent",
        "Whoosh"
      ],
      "title": "Sfx Whoosh Deep Vent 1 5.wav"
    },
    {
      "attribution": "\"Sfx Whoosh Deep Vent 1 12.wav\" by Sheyvan is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Whoosh",
        "url": "https://freesound.org/apiv2/packs/31928/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "Sheyvan",
        "url": "https://freesound.org/people/Sheyvan"
      },
      "download_url": null,
      "duration_seconds": 1.23,
      "filesize_bytes": 29088,
      "format": "mp3",
      "genres": [],
      "id": "bb159e82-819d-44e1-8da2-ab78d09e48c0",
      "indexed_at": "2022-06-01T12:00:12.608809Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/bb159e82-819d-44e1-8da2-ab78d09e48c0",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 178838,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/Sheyvan/sounds/569414",
      "preview_url": "https://cdn.freesound.org/previews/569/569414_3248005-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "Deep",
        "Sfx",
        "Vent",
        "Whoosh"
      ],
      "title": "Sfx Whoosh Deep Vent 1 12.wav"
    },
    {
      "attribution": "\"Sfx Whoosh Deep Vent 1 3.wav\" by Sheyvan is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Whoosh",
        "url": "https://freesound.org/apiv2/packs/31928/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "Sheyvan",
        "url": "https://freesound.org/people/Sheyvan"
      },
      "download_url": null,
      "duration_seconds": 2.65,
      "filesize_bytes": 59712,
      "format": "mp3",
      "genres": [],
      "id": "a51d757d-ff2b-454f-9fc0-e358ec74f816",
      "indexed_at": "2022-06-01T12:00:12.608809Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/a51d757d-ff2b-454f-9fc0-e358ec74f816",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 382970,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/Sheyvan/sounds/569418",
      "preview_url": "https://cdn.freesound.org/previews/569/569418_3248005-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "Vent",
        "Whoosh",
        "Deep",
        "Sfx"
      ],
      "title": "Sfx Whoosh Deep Vent 1 3.wav"
    },
    {
      "attribution": "\"Pen whoosh 1.wav\" by saturdaysoundguy is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Whooshes",
        "url": "https://freesound.org/apiv2/packs/21823/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "saturdaysoundguy",
        "url": "https://freesound.org/people/saturdaysoundguy"
      },
      "download_url": null,
      "duration_seconds": 7.21,
      "filesize_bytes": 165648,
      "format": "mp3",
      "genres": [],
      "id": "986fd906-9037-455f-b480-eea5bff5688f",
      "indexed_at": "2022-10-01T04:02:44.560321Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/986fd906-9037-455f-b480-eea5bff5688f",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 1044926,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/saturdaysoundguy/sounds/391441",
      "preview_url": "https://cdn.freesound.org/previews/391/391441_7280678-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "arrow",
        "bow",
        "swhish",
        "swing",
        "swish",
        "swoosh",
        "whistle",
        "whoosh",
        "woosh"
      ],
      "title": "Pen whoosh 1.wav"
    },
    {
      "attribution": "\"Deep Whoosh #3\" by Kinoton is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Transitions",
        "url": "https://freesound.org/apiv2/packs/19970/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "Kinoton",
        "url": "https://freesound.org/people/Kinoton"
      },
      "download_url": null,
      "duration_seconds": 8.75,
      "filesize_bytes": 197808,
      "format": "mp3",
      "genres": [],
      "id": "dabfec00-7ccb-4c3c-aa58-272560473a0d",
      "indexed_at": "2024-05-21T15:00:07.873258Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/dabfec00-7ccb-4c3c-aa58-272560473a0d",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 2527252,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/Kinoton/sounds/369502",
      "preview_url": "https://cdn.freesound.org/previews/369/369502_2247456-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "air",
        "sfx",
        "sound-design",
        "soundeffect",
        "sweeping",
        "swish",
        "swoosh",
        "swosh",
        "transition",
        "whoosh",
        "wind"
      ],
      "title": "Deep Whoosh #3"
    },
    {
      "attribution": "\"Sfx Whoosh Deep Vent 1 4.wav\" by Sheyvan is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Whoosh",
        "url": "https://freesound.org/apiv2/packs/31928/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "Sheyvan",
        "url": "https://freesound.org/people/Sheyvan"
      },
      "download_url": null,
      "duration_seconds": 1.61,
      "filesize_bytes": 37056,
      "format": "mp3",
      "genres": [],
      "id": "3891f406-54b5-4395-aaa1-6e923cd7ce1b",
      "indexed_at": "2022-06-01T12:00:12.608809Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/3891f406-54b5-4395-aaa1-6e923cd7ce1b",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 232970,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/Sheyvan/sounds/569423",
      "preview_url": "https://cdn.freesound.org/previews/569/569423_3248005-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "Vent",
        "Whoosh",
        "Deep",
        "Sfx"
      ],
      "title": "Sfx Whoosh Deep Vent 1 4.wav"
    },
    {
      "attribution": "\"Vocalised Buzzy Whoosh (38) 1.wav\" by Speedenza is licensed under CC BY-NC 4.0. To view a copy of this license, visit https://creativecommons.org/licenses/by-nc/4.0/.",
      "audio_set": null,
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "Speedenza",
        "url": "https://freesound.org/people/Speedenza"
      },
      "download_url": null,
      "duration_seconds": 1.52,
      "filesize_bytes": 36684,
      "format": "mp3",
      "genres": [],
      "id": "344ae5e8-c3a2-4604-be5d-1575e8594de8",
      "indexed_at": "2023-03-20T17:21:54.283284Z",
      "license": {
        "attribution_required": true,
        "code": "by-nc",
        "commercial_use": false,
        "modification_allowed": true,
        "name": "CC BY-NC 4.0",
        "url": "https://creativecommons.org/licenses/by-nc/4.0/",
        "version": "4.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/344ae5e8-c3a2-4604-be5d-1575e8594de8",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 267592,
        "format": "wav",
        "sample_rate": 44100
      },
      "page_url": "https://freesound.org/people/Speedenza/sounds/167836",
      "preview_url": "https://cdn.freesound.org/previews/167/167836_2962530-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "buzzy",
        "whoosh",
        "zoom",
        "vocal",
        "swoosh",
        "swosh"
      ],
      "title": "Vocalised Buzzy Whoosh (38) 1.wav"
    },
    {
      "attribution": "\"Whoosh in-out #1\" by beman87 is licensed under CC BY 3.0. To view a copy of this license, visit https://creativecommons.org/licenses/by/3.0/.",
      "audio_set": {
        "title": "Whoosh",
        "url": "https://freesound.org/apiv2/packs/10099/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "beman87",
        "url": "https://freesound.org/people/beman87"
      },
      "download_url": null,
      "duration_seconds": 8.51,
      "filesize_bytes": 194688,
      "format": "mp3",
      "genres": [],
      "id": "be9495ee-321e-481a-9346-5ac8844d1864",
      "indexed_at": "2024-05-21T15:00:07.873258Z",
      "license": {
        "attribution_required": true,
        "code": "by",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC BY 3.0",
        "url": "https://creativecommons.org/licenses/by/3.0/",
        "version": "3.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/be9495ee-321e-481a-9346-5ac8844d1864",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 1634600,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/beman87/sounds/162841",
      "preview_url": "https://cdn.freesound.org/previews/162/162841_532963-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "air",
        "swoosh",
        "whoosh"
      ],
      "title": "Whoosh in-out #1"
    },
    {
      "attribution": "\"Sfx Whoosh Deep Vent 1 1.wav\" by Sheyvan is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Whoosh",
        "url": "https://freesound.org/apiv2/packs/31928/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "Sheyvan",
        "url": "https://freesound.org/people/Sheyvan"
      },
      "download_url": null,
      "duration_seconds": 2.62,
      "filesize_bytes": 58320,
      "format": "mp3",
      "genres": [],
      "id": "a9031f6f-bd67-44a0-a818-4b823046b66b",
      "indexed_at": "2022-06-01T12:00:12.608809Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/a9031f6f-bd67-44a0-a818-4b823046b66b",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 378908,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/Sheyvan/sounds/569417",
      "preview_url": "https://cdn.freesound.org/previews/569/569417_3248005-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "Vent",
        "Whoosh",
        "Deep",
        "Sfx"
      ],
      "title": "Sfx Whoosh Deep Vent 1 1.wav"
    },
    {
      "attribution": "\"Sfx Whoosh Deep Vent 1 9\" by Sheyvan is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Whoosh",
        "url": "https://freesound.org/apiv2/packs/31928/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "Sheyvan",
        "url": "https://freesound.org/people/Sheyvan"
      },
      "download_url": null,
      "duration_seconds": 1.51,
      "filesize_bytes": 35136,
      "format": "mp3",
      "genres": [],
      "id": "1ff35f4c-bbeb-44e4-91ae-ba169cb42146",
      "indexed_at": "2022-06-01T12:00:12.608809Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/1ff35f4c-bbeb-44e4-91ae-ba169cb42146",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 219893,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/Sheyvan/sounds/569425",
      "preview_url": "https://cdn.freesound.org/previews/569/569425_3248005-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "Deep",
        "Sfx",
        "Vent",
        "Whoosh"
      ],
      "title": "Sfx Whoosh Deep Vent 1 9"
    }
  ],
  "source_url": "https://api.openverse.org/v1/audio/eab8a6e2-0ac8-4615-9e0d-ebde30523783/related/"
}
```

### Search audio

- Capability: `audio-assets/search_audio`
- Description: Search Openverse's openly licensed audio by keyword. Filters by licence, commercial use, modification, source collection (freesound, jamendo, wikimedia_audio), category, length bucket and file type; pages with continuation (anonymous access: up to 20 per page and 240 results deep). Every result carries title, creator, a licence object with commercial_use and attribution_required, ready-to-paste attribution, duration in seconds, format, sample rate when known, tags, the source page URL and a preview URL. Accepts an Openverse audio search URL.
- Instructions: Find reusable sound effects or music under a licence: "CC0 whoosh sound effects", "rain on window, CC BY or CC0, under 2 minutes", "commercially usable piano music". Use get_audio for one item, related_audio for similar ones.
- Cost: 5 credits per call
- Capability file: [Search audio](https://firecrawl.dev/alexandria/agents/providers/openverse-org/audio-assets/search_audio)

Accepted options:
- `category` (string[]): Keep only these categories. Mostly set on Jamendo music; most Freesound sound effects are uncategorised, so prefer source: freesound for sound effects. Example: `[]`
- `commercial_use` (boolean): true keeps only licences that allow commercial use (drops every NC licence). false applies no filter. Example: `false`
- `continuation` (string): Cursor from a previous call. Example: `<continuation>`
- `extension` (string[]): Keep only these file types, e.g. wav, mp3, flac, ogg (matches the original or the preview). Example: `[]`
- `length` (string[]): Keep only these lengths: shortest (under 30 s), short (30 s to 2 min), medium (2 to 10 min), long (over 10 min). Example: `[]`
- `license` (string[]): Keep only these licences. Example: `[]`
- `limit` (number): Results per page; default 10. Anonymous access allows at most 20. Example: `10`
- `modification_allowed` (boolean): true keeps only licences that allow remixing (drops ND licences). false applies no filter. Example: `false`
- `query` (string): Words to search titles, tags and descriptions, e.g. rain on window. Example: `<query>`
- `source` (string[]): Keep only these collections (names from list_sources): freesound for sound effects and samples, jamendo for music, wikimedia_audio for Wikimedia Commons. Example: `[]`
- `url` (string): An openverse.org/search/audio?q=... or api.openverse.org/v1/audio/?q=... URL; its q, license, license_type, source, category, length and extension fill any filter not given. Example: `<url>`

Response schema example:
```json
{
  "count": 5,
  "credit": "Made using Openverse; not endorsed or certified by Openverse.",
  "filters": {
    "category": [],
    "extension": [],
    "length": [],
    "license": [
      "cc0"
    ],
    "license_type": [],
    "source": [
      "freesound"
    ]
  },
  "observed_at_ms": 1793743200000,
  "page": 1,
  "page_count": 48,
  "page_size": 5,
  "query": "whoosh",
  "results": [
    {
      "attribution": "\"Deep Whoosh #1\" by Kinoton is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Transitions",
        "url": "https://freesound.org/apiv2/packs/19970/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "Kinoton",
        "url": "https://freesound.org/people/Kinoton"
      },
      "download_url": null,
      "duration_seconds": 3.16,
      "filesize_bytes": 69196,
      "format": "mp3",
      "genres": [],
      "id": "eab8a6e2-0ac8-4615-9e0d-ebde30523783",
      "indexed_at": "2024-05-21T15:00:07.873258Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/eab8a6e2-0ac8-4615-9e0d-ebde30523783",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 841236,
        "format": "wav",
        "sample_rate": 44100
      },
      "page_url": "https://freesound.org/people/Kinoton/sounds/351256",
      "preview_url": "https://cdn.freesound.org/previews/351/351256_2247456-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "air",
        "sfx",
        "sound-design",
        "soundeffect",
        "sweeping",
        "swish",
        "swoosh",
        "swosh",
        "transition",
        "whoosh",
        "wind"
      ],
      "title": "Deep Whoosh #1"
    },
    {
      "attribution": "\"Swosh swoosh whoosh air sound, free, high quality\" by qubodup is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Free Whoosh Sound Pack",
        "url": "https://freesound.org/apiv2/packs/12143/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "qubodup",
        "url": "https://freesound.org/people/qubodup"
      },
      "download_url": null,
      "duration_seconds": 0.49,
      "filesize_bytes": 13358,
      "format": "mp3",
      "genres": [],
      "id": "f1dc6045-7965-41de-87f8-4731d2583fd2",
      "indexed_at": "2024-05-21T15:00:07.873258Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/f1dc6045-7965-41de-87f8-4731d2583fd2",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 85326,
        "format": "flac",
        "sample_rate": 44100
      },
      "page_url": "https://freesound.org/people/qubodup/sounds/60026",
      "preview_url": "https://cdn.freesound.org/previews/60/60026_71257-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "air",
        "attack",
        "bamboo",
        "cut",
        "domain",
        "flup",
        "h2",
        "luft",
        "public",
        "public-domain",
        "punch",
        "stick",
        "swash",
        "swhish",
        "swing",
        "swish",
        "swoosh",
        "swosh",
        "weapon",
        "whip",
        "whoosh",
        "wind",
        "wisch",
        "wish",
        "woosh",
        "zoom",
        "zoom-h2"
      ],
      "title": "Swosh swoosh whoosh air sound, free, high quality"
    },
    {
      "attribution": "\"Swipe Whoosh\" by qubodup is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": {
        "title": "Free Whoosh Sound Pack",
        "url": "https://freesound.org/apiv2/packs/12143/"
      },
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "qubodup",
        "url": "https://freesound.org/people/qubodup"
      },
      "download_url": null,
      "duration_seconds": 0.45,
      "filesize_bytes": 12211,
      "format": "mp3",
      "genres": [],
      "id": "b7ae7822-8ec5-4a82-b6f8-d539b51caa61",
      "indexed_at": "2024-05-21T15:00:07.873258Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/b7ae7822-8ec5-4a82-b6f8-d539b51caa61",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 73109,
        "format": "flac",
        "sample_rate": 44100
      },
      "page_url": "https://freesound.org/people/qubodup/sounds/60007",
      "preview_url": "https://cdn.freesound.org/previews/60/60007_71257-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "air",
        "attack",
        "bamboo",
        "cut",
        "domain",
        "flup",
        "h2",
        "luft",
        "public",
        "public-domain",
        "punch",
        "stick",
        "swash",
        "swhish",
        "swing",
        "swipe",
        "swish",
        "swoosh",
        "swosh",
        "weapon",
        "whip",
        "whoosh",
        "wind",
        "wisch",
        "wish",
        "woosh",
        "zoom",
        "zoom-h2"
      ],
      "title": "Swipe Whoosh"
    },
    {
      "attribution": "\"Cartoony whooshes\" by BranRainey is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": null,
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "BranRainey",
        "url": "https://freesound.org/people/BranRainey"
      },
      "download_url": null,
      "duration_seconds": 2.34,
      "filesize_bytes": 45101,
      "format": "mp3",
      "genres": [],
      "id": "0453066f-9cb0-426e-b51f-539f0b2acabb",
      "indexed_at": "2024-05-21T15:00:07.873258Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/0453066f-9cb0-426e-b51f-539f0b2acabb",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 417544,
        "format": "wav",
        "sample_rate": 44100
      },
      "page_url": "https://freesound.org/people/BranRainey/sounds/142348",
      "preview_url": "https://cdn.freesound.org/previews/142/142348_757844-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "cartoon",
        "smack",
        "swish",
        "whip",
        "whoosh"
      ],
      "title": "Cartoony whooshes"
    },
    {
      "attribution": "\"processed swish, swoosh, whoosh\" by MadMaxSFX is marked with CC0 1.0. To view the terms, visit https://creativecommons.org/publicdomain/zero/1.0/.",
      "audio_set": null,
      "bit_rate": 128000,
      "category": null,
      "creator": {
        "name": "MadMaxSFX",
        "url": "https://freesound.org/people/MadMaxSFX"
      },
      "download_url": null,
      "duration_seconds": 5.8,
      "filesize_bytes": 122832,
      "format": "mp3",
      "genres": [],
      "id": "86d2b266-79f3-4fa0-97e2-3a49860c8e6d",
      "indexed_at": "2024-05-21T15:00:07.873258Z",
      "license": {
        "attribution_required": false,
        "code": "cc0",
        "commercial_use": true,
        "modification_allowed": true,
        "name": "CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "version": "1.0"
      },
      "mature": false,
      "openverse_url": "https://openverse.org/audio/86d2b266-79f3-4fa0-97e2-3a49860c8e6d",
      "original": {
        "bit_rate": null,
        "filesize_bytes": 863544,
        "format": "wav",
        "sample_rate": 48000
      },
      "page_url": "https://freesound.org/people/MadMaxSFX/sounds/327990",
      "preview_url": "https://cdn.freesound.org/previews/327/327990_4799665-hq.mp3",
      "provider": "freesound",
      "sample_rate": null,
      "source": "freesound",
      "tags": [
        "swish",
        "swoosh",
        "swosh",
        "whoosh",
        "woosh"
      ],
      "title": "processed swish, swoosh, whoosh"
    }
  ],
  "source_url": "https://api.openverse.org/v1/audio/?q=whoosh&license=cc0&source=freesound&page_size=5",
  "total": 240,
  "total_capped": true
}
```
