Crawlzodocs
API referenceFacebook

Facebook sound discover

Facebook sound DISCOVERY (reverse index), the scalable, public substitute for a (requires an authenticated session, infeasible) FB audio keyword search.

Facebook sound DISCOVERY (reverse index), the scalable, public substitute for a (requires an authenticated session, infeasible) FB audio keyword search.

Crawls a creator's reels and groups them by their attributed sound, returning the distinct sounds the creator uses + the reels under each. This is NOT a free-text keyword search: FB attaches a sound entity only to Reels, and FB web search itself is requires an authenticated session. Feed any discovered audio id / sound_link into /facebook-sound-v2 to list every reel using that sound.

The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 24.7s.

POST
/v1/scrapers/facebook-sound-discover

Authorization

ApiKeyAuth
X-API-Key<token>

Your API key. Sent on every request.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/scrapers/facebook-sound-discover" \  -H "Content-Type: application/json" \  -d '{    "username": "coldplay",    "count": 40  }'
{  "request_id": "req_8f2c1d94e7b0",  "success": true,  "status": {    "code": "OK",    "message": "Scrape completed.",    "retryable": false  },  "data": {    "identifier": "coldplay",    "reels_scanned": 41,    "sounds": [      {        "artist": "Coldplay",        "duration_ms": null,        "id": "1027971735698251",        "is_original": false,        "reel_count": 4,        "reels_using": [          {            "content_id": "1441422990687346",            "content_link": "https://www.facebook.com/reel/1441422990687346",            "content_type": "reel"          },          {            "content_id": "1433725918123720",            "content_link": "https://www.facebook.com/reel/1433725918123720",            "content_type": "reel"          },          "… 2 more items in the full response"        ],        "sound_link": "https://www.facebook.com/reel/audio/1027971735698251",        "thumbnail_url": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-6/467607239_90029226330718_4127226939309294691_n.jpg?stp=dst-jpg_tt6&cstp=mx2048x2048&ctp=s168x128&_nc_cat=104&ccb=1-7&_nc_sid=2f2557&_nc_ohc=CACrmIsXztkQ7kNvwGcII9h&_nc_oc=AdoZ9320rTtxxCD3aXN9ptKX6wUU_JRTSEKRzMs-8asjQ9yyEDaCxPYEfk3-WINna4eQHV_YZJtK2F0kz5FCWMTC&_nc_zt=23… (+135 chars)",        "title": "ALL MY LOVE",        "type": "licensed",        "usage_count": null      },      {        "artist": "Coldplay",        "duration_ms": null,        "id": "457637100013805",        "is_original": false,        "reel_count": 4,        "reels_using": [          {            "content_id": "1312304390265874",            "content_link": "https://www.facebook.com/reel/1312304390265874",            "content_type": "reel"          },          {            "content_id": "1310164840479829",            "content_link": "https://www.facebook.com/reel/1310164840479829",            "content_type": "reel"          },          "… 2 more items in the full response"        ],        "sound_link": "https://www.facebook.com/reel/audio/457637100013805",        "thumbnail_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.30808-6/461809923_90028946284028_9105426532175260506_n.jpg?stp=dst-jpg_s168x128_tt6&_nc_cat=109&ccb=1-7&_nc_sid=2f2557&_nc_ohc=pa_QEEk5GBYQ7kNvwH8HzDb&_nc_oc=AdpJSO6D2MGUGiKPi5piM6ATclB8IPMJIzMPk6AQcoAIPPV6uONZohsHU0o9k_SJ1lWNCcrd8AkGbm82337_I9ta&_nc_zt=23&_nc_ht=scontent-ord5… (+114 chars)",        "title": "iAAM",        "type": "licensed",        "usage_count": null      },      "… 32 more items in the full response"    ],    "total_sounds": 34  },  "error": null,  "meta": {    "client_id": "client_abc123",    "scraper": "facebook-sound-discover",    "billable": true,    "duration_ms": 23980  }}