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.

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  }}