Skip to main content
POST
Bridgly SDK

Authorizations

Authorization
string
header
required

A Bridgly API key (bgly_…). Metered endpoints deduct credits from the resolved account.

Body

application/json
audioId
string
required

Numeric audio ID, or the audio page link, e.g. "6516695721690591" or "https://www.instagram.com/reels/audio/6516695721690591/".

Minimum string length: 1
count
integer
default:10

Number of results to return (1–10). Defaults to 10.

Required range: 1 <= x <= 10
cursor
string

The previous response's nextCursor, to fetch the next page. Omit it for the first page.

cacheMaxAgeHours
integer

Accept a cached result scraped up to this many hours ago. A cached result costs no credits, and its cachedAt says when it was scraped. When no cached result is that recent, the data is scraped live at the normal price. Leave it out to always scrape live, e.g. 24.

Required range: x <= 9007199254740991
cacheOnly
boolean

Return only a cached result and never scrape live. With cacheMaxAgeHours, only a result that recent is returned; without it, the latest cached result of any age. Responds 404, at no cost, when there is none, e.g. true.

Response

Default Response

timeMs
number
required

Wall-clock time the request took to complete, in milliseconds.

creditsCost
number
required

Number of account credits this request consumed.

cachedAt
string<date-time> | null
required

When the returned data was scraped, if it came from the cache. Null when it was scraped live for this request.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
data
object
required