/v1/instagram/audio/reels
Get Reels By Audio Id
Get public reels associated with an Instagram audio ID.
| Credit cost | Default: 1 credit How charges are determinedCost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute. |
|---|---|
| Cache support | Not specified in the published contract. |
| Pagination | No explicit pagination metadata in the published contract. Consult the parameters and response fields below. |
Parameters
| Name | Location / required | Schema |
|---|---|---|
audio_idAudio ID from the Instagram audio page URL. | query / required |
|
cursorPass the previous response's cursor for the next page. | query / optional |
|
Request examples
Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.
cURL
curl --request GET 'https://api.fetchproof.com/v1/instagram/audio/reels?audio_id=YOUR_AUDIO_ID' \
--header 'x-api-key: YOUR_API_KEY'JavaScript
const response = await fetch("https://api.fetchproof.com/v1/instagram/audio/reels?audio_id=YOUR_AUDIO_ID", {
method: 'GET',
headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());Python
import os
import requests
response = requests.get("https://api.fetchproof.com/v1/instagram/audio/reels?audio_id=YOUR_AUDIO_ID",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)Responses
200Success. Envelope: success / credits_remaining / credits_charged.
application/json
object
successrequired
boolean
credits_remainingrequired
integer
credits_chargedrequired
integer
reelsrequired
array
Array items
object
gen_ai_chat_with_ai_cta_infooptional
null
collaborator_edit_eligibilityrequired
boolean
number_of_qualitiesrequired
integer
related_ads_pivots_media_inforequired
string
is_artist_pickoptional
boolean
translated_langs_for_autodubrequired
array
subtype_name_for_REST__required
string
is_eligible_for_poerequired
boolean
original_lang_for_translationsrequired
string
eligible_insights_entrypointsrequired
string
igbio_productrequired
null
hidden_likes_string_variantrequired
integer
is_social_ufi_disabledrequired
boolean
boost_unavailable_reasonrequired
null
boost_unavailable_identifierrequired
null
boost_unavailable_reason_v2required
array
client_cache_keyrequired
string
can_replyoptional
boolean
photo_of_yourequired
boolean
media_attributions_datarequired
array
can_view_more_preview_commentsrequired
boolean
mezql_tokenrequired
string
has_tagged_usersrequired
boolean
is_eligible_content_for_post_roll_adrequired
boolean
is_cutout_sticker_allowedrequired
boolean
is_photo_comments_composer_enabled_for_authorrequired
boolean
hide_view_all_comment_entrypointrequired
boolean
has_likedrequired
boolean
is_organic_product_tagging_eligiblerequired
boolean
view_state_item_typerequired
integer
video_sticker_localesrequired
array
is_paid_partnershiprequired
boolean
is_in_profile_gridrequired
boolean
is_tagged_media_shared_to_viewer_profile_gridrequired
boolean
should_show_author_pog_for_tagged_media_shared_to_profile_gridrequired
boolean
inventory_sourceoptional
string
integrity_review_decisionrequired
string
has_delayed_metadatarequired
boolean
filter_typerequired
integer
deleted_reasonrequired
integer
device_timestamprequired
integer
is_reshare_of_text_post_app_media_in_igrequired
boolean
timeline_pinned_user_idsrequired
array
is_open_to_public_submissionrequired
boolean
profile_grid_control_enabledrequired
boolean
can_see_insights_as_brandrequired
boolean
media_reposter_bottomsheet_enabledrequired
boolean
coauthor_producer_can_see_organic_insightsrequired
boolean
share_count_disabledrequired
boolean
is_visual_reply_commenter_notice_enabledrequired
boolean
should_request_adsrequired
boolean
subscribe_cta_visiblerequired
boolean
sharing_friction_inforequired
object
bloks_app_urlrequired
null
sharing_friction_payloadrequired
null
should_have_sharing_frictionrequired
boolean
media_overlay_inforequired
null
fb_user_tagsrequired
object
inrequired
array
coauthor_producersrequired
array
cutout_sticker_inforequired
array
invited_coauthor_producersrequired
array
gen_ai_detection_methodrequired
object
detection_methodrequired
string
comment_inform_treatmentrequired
object
should_have_inform_treatmentrequired
boolean
textrequired
string
action_typerequired
null
urlrequired
null
creative_configrequired
null
captionrequired
object
strong_id__required
string
pkrequired
string
bit_flagsrequired
integer
content_typerequired
string
created_atrequired
integer
created_at_utcrequired
integer
did_report_as_spamrequired
boolean
is_coveredrequired
boolean
is_ranked_commentrequired
boolean
media_idrequired
string
private_reply_statusrequired
integer
share_enabledrequired
boolean
statusrequired
string
textrequired
string
typerequired
integer
userrequired
object
strong_id__required
string
idrequired
string
pkrequired
integer
pk_idrequired
string
usernamerequired
string
full_namerequired
string
is_privaterequired
boolean
is_verifiedrequired
boolean
profile_pic_idrequired
string
profile_pic_urlrequired
string
fbid_v2required
string
is_unpublishedrequired
boolean
user_idrequired
integer
music_metadatarequired
null
meta_ai_suggested_promptsrequired
array
userrequired
object
is_embeds_disabledrequired
boolean
idrequired
string
pkrequired
integer
pk_idrequired
string
strong_id__required
string
fbid_v2required
string
profile_pic_idrequired
string
profile_pic_urlrequired
string
eligible_for_text_app_activation_badgerequired
boolean
interop_messaging_user_fbidrequired
schema
anyOf
string
anyOf
integer
usernamerequired
string
full_namerequired
string
is_privaterequired
boolean
is_unpublishedrequired
boolean
is_verifiedrequired
boolean
show_account_transparency_detailsrequired
boolean
transparency_product_enabledrequired
boolean
third_party_downloads_enabledrequired
integer
feed_post_reshare_disabledrequired
boolean
account_badgesrequired
array
account_typerequired
integer
has_anonymous_profile_picturerequired
boolean
fan_club_inforequired
object
autosave_to_exclusive_highlightrequired
null
connected_member_countrequired
null
fan_club_idrequired
null
fan_club_namerequired
null
fan_consideration_page_revamp_eligiblityrequired
null
has_enough_subscribers_for_sscrequired
null
is_fan_club_gifting_eligiblerequired
null
is_fan_club_referral_eligiblerequired
null
subscriber_countrequired
null
has_created_sscrequired
null
is_free_trial_eligiblerequired
null
largest_public_bc_idrequired
null
should_show_playlists_in_profile_tabrequired
null
clips_metadatarequired
object
achievements_inforequired
object
num_earned_achievementsrequired
null
show_achievementsrequired
boolean
additional_audio_inforequired
object
additional_audio_usernamerequired
null
audio_reattribution_inforequired
object
should_allow_restorerequired
boolean
asset_recommendation_inforequired
null
audio_ranking_inforequired
object
best_audio_cluster_idrequired
string
audio_typerequired
string
branded_content_tag_inforequired
object
can_add_tagrequired
boolean
clips_creation_entry_pointrequired
string
content_appreciation_inforequired
object
enabledrequired
boolean
entry_point_containerrequired
object
commentrequired
object
action_typerequired
string
overflowrequired
null
pillrequired
object
action_typerequired
string
priorityrequired
integer
contextual_highlight_inforequired
null
cutout_sticker_inforequired
array
disable_use_in_clips_client_cacherequired
boolean
featured_labelrequired
null
is_fan_club_promo_videorequired
null
is_public_chat_welcome_videorequired
boolean
is_shared_to_fbrequired
boolean
mashup_inforequired
object
can_toggle_mashups_allowedrequired
boolean
formatted_mashups_countrequired
null
has_been_mashed_uprequired
boolean
has_nonmimicable_additional_audiorequired
boolean
is_creator_requesting_mashuprequired
boolean
is_light_weight_checkrequired
boolean
is_pivot_page_availablerequired
boolean
is_light_weight_reuse_allowed_checkrequired
boolean
is_reuse_allowedrequired
boolean
mashup_typerequired
null
mashups_allowedrequired
boolean
non_privacy_filtered_mashups_media_countrequired
integer
original_mediarequired
null
privacy_filtered_mashups_media_countrequired
null
music_canonical_idrequired
string
music_inforequired
object
music_asset_inforequired
object
allows_savingrequired
boolean
artist_idrequired
string
audio_asset_idrequired
string
audio_cluster_idrequired
string
cover_artwork_thumbnail_urirequired
string
cover_artwork_urirequired
string
dark_messagerequired
null
dash_manifestrequired
null
display_artistrequired
string
duration_in_msrequired
integer
fast_start_progressive_download_urlrequired
string
has_lyricsrequired
boolean
highlight_start_times_in_msrequired
array
Array items
integer
idrequired
string
ig_usernamerequired
string
is_eligible_for_audio_effectsrequired
boolean
is_explicitrequired
boolean
progressive_download_urlrequired
string
reactive_audio_download_urlrequired
null
sanitized_titlerequired
null
subtitlerequired
string
titlerequired
string
spotify_track_metadatarequired
null
lyricsrequired
null
song_monetization_inforequired
null
licensed_music_subtyperequired
string
is_eligible_for_vinyl_stickerrequired
boolean
web_30s_preview_download_urlrequired
string
music_consumption_inforequired
object
allow_media_creation_with_musicrequired
boolean
audio_asset_start_time_in_msrequired
integer
derived_content_start_time_in_composition_in_msrequired
null
display_labelsrequired
null
audio_filter_infosrequired
array
audio_muting_inforequired
object
allow_audio_editingrequired
boolean
mute_audiorequired
boolean
mute_reason_strrequired
string
show_muted_audio_toastrequired
boolean
contains_lyricsrequired
null
derived_content_idrequired
null
ig_artistrequired
object
strong_id__required
string
idrequired
string
full_namerequired
string
is_privaterequired
boolean
is_verifiedrequired
boolean
pkrequired
integer
pk_idrequired
string
profile_pic_idrequired
string
profile_pic_urlrequired
string
usernamerequired
string
is_bookmarkedrequired
boolean
is_trending_in_clipsrequired
boolean
overlap_duration_in_msrequired
integer
placeholder_profile_pic_urlrequired
string
should_allow_music_editingrequired
boolean
should_mute_audiorequired
boolean
should_mute_audio_reasonrequired
string
should_render_soundwaverequired
boolean
trend_rankrequired
null
previous_trend_rankrequired
null
nux_inforequired
null
original_sound_inforequired
object
is_eligible_for_vinyl_stickerrequired
boolean
allow_creator_to_renamerequired
boolean
overlap_duration_in_msrequired
integer
audio_asset_start_time_in_msrequired
integer
derived_content_start_time_in_composition_in_msrequired
integer
audio_asset_idrequired
string
audio_filter_infosrequired
null
audio_partsrequired
array
audio_parts_by_filterrequired
array
can_remix_be_shared_to_fbrequired
boolean
can_remix_be_shared_to_fb_expansionrequired
boolean
consumption_inforequired
object
display_media_idrequired
null
is_bookmarkedrequired
boolean
is_trending_in_clipsrequired
boolean
should_mute_audio_reasonrequired
string
display_labelsrequired
array
Array items
string
dash_manifestrequired
string
duration_in_msrequired
integer
hide_remixingrequired
boolean
fb_downstream_use_xpost_metadatarequired
object
downstream_use_xpost_deny_reasonrequired
string
ig_artistrequired
object
strong_id__required
string
pk_idrequired
string
idrequired
string
full_namerequired
string
is_privaterequired
boolean
is_verifiedrequired
boolean
pkrequired
integer
profile_pic_idrequired
string
profile_pic_urlrequired
string
usernamerequired
string
is_audio_automatically_attributedrequired
boolean
is_eligible_for_audio_effectsrequired
boolean
is_explicitrequired
boolean
is_original_audio_download_eligiblerequired
boolean
is_reuse_disabledrequired
boolean
is_xpost_from_fbrequired
boolean
music_canonical_idrequired
null
oa_owner_is_music_artistrequired
boolean
original_audio_subtyperequired
string
original_audio_titlerequired
string
original_media_idrequired
string
progressive_download_urlrequired
string
should_mute_audiorequired
boolean
time_createdrequired
integer
trend_rankrequired
null
xpost_fb_creator_inforequired
null
originality_inforequired
null
professional_clips_upsell_typerequired
integer
show_achievementsrequired
boolean
reels_on_the_rise_inforequired
null
reusable_text_attribute_stringrequired
null
reusable_text_inforequired
null
shopping_inforequired
null
template_inforequired
null
viewer_interaction_settingsrequired
null
idrequired
string
strong_id__required
string
pkrequired
string
fbidrequired
string
media_typerequired
integer
like_and_view_counts_disabledrequired
boolean
coderequired
string
taken_atrequired
integer
product_typerequired
string
caption_is_editedrequired
boolean
can_viewer_resharerequired
boolean
can_viewer_saverequired
boolean
comment_countrequired
integer
are_remixes_crosspostablerequired
boolean
video_versionsrequired
array
Array items
object
urlrequired
string
heightrequired
integer
widthrequired
integer
typerequired
integer
idrequired
string
fallbackrequired
null
url_expiration_timestamp_usrequired
null
bandwidthrequired
integer
progressive_identifieroptional
string
image_versions2required
object
candidatesrequired
array
Array items
object
estimated_scans_sizesrequired
array
heightrequired
integer
scans_profilerequired
null
urlrequired
string
widthrequired
integer
additional_candidatesrequired
object
first_framerequired
object
estimated_scans_sizesrequired
array
heightrequired
integer
scans_profilerequired
null
urlrequired
string
widthrequired
integer
igtv_first_framerequired
object
estimated_scans_sizesrequired
array
heightrequired
integer
scans_profilerequired
null
urlrequired
string
widthrequired
integer
smart_framerequired
null
scrubber_spritesheet_info_candidatesrequired
object
defaultrequired
object
sprite_urlsrequired
array
Array items
string
file_size_kbrequired
integer
max_thumbnails_per_spriterequired
integer
rendered_widthrequired
integer
sprite_heightrequired
integer
sprite_widthrequired
integer
thumbnail_durationrequired
number
thumbnail_heightrequired
integer
thumbnail_widthrequired
integer
thumbnails_per_rowrequired
integer
total_thumbnail_num_per_spriterequired
integer
video_lengthrequired
number
smart_thumbnail_enabledrequired
null
has_audiorequired
boolean
like_countrequired
integer
locationsrequired
array
is_dash_eligiblerequired
integer
is_unified_videorequired
boolean
enable_media_notes_productionrequired
boolean
play_countrequired
integer
fb_play_countoptional
integer
ig_play_countrequired
integer
is_third_party_downloads_eligiblerequired
boolean
original_widthrequired
integer
original_heightrequired
integer
is_reuse_allowedrequired
boolean
has_shared_to_fbrequired
integer
has_privately_likedrequired
boolean
ig_media_sharing_disabledrequired
boolean
organic_tracking_tokenrequired
string
has_views_fetchingrequired
boolean
video_durationrequired
number
is_post_live_clips_mediarequired
boolean
is_quiet_postrequired
boolean
is_comments_gif_composer_enabledrequired
boolean
clips_tab_pinned_user_idsrequired
array
media_ui_attributions_dataoptional
array
usertagsoptional
object
inrequired
array
Array items
object
show_category_of_userrequired
null
positionrequired
array
Array items
integer
userrequired
object
strong_id__required
string
idrequired
string
full_namerequired
string
has_onboarded_to_text_post_apprequired
null
is_privaterequired
boolean
is_verifiedrequired
boolean
pkrequired
string
pk_idrequired
string
profile_pic_idrequired
string
profile_pic_urlrequired
string
usernamerequired
string
media_cropping_infooptional
object
four_by_three_croprequired
object
crop_leftrequired
integer
crop_rightrequired
integer
crop_toprequired
number
crop_bottomrequired
number
video_dash_manifestoptional
string
wearable_attribution_infooptional
object
attribution_cta_action_urlrequired
string
attribution_cta_textrequired
string
pivot_page_cta_labelrequired
null
pivot_page_cta_urlrequired
null
pivot_page_descriptionrequired
null
pivot_page_image_urlrequired
null
pivot_page_titlerequired
null
attribution_icon_urlrequired
string
attribution_subtitlerequired
string
attribution_titlerequired
string
attribution_top_icon_urlrequired
string
attribution_typerequired
string
reels_pill_attribution_titlerequired
string
gating_reasonrequired
string
iconic_current_presencerequired
null
iconic_horizon_world_deeplinkrequired
null
iconic_horizon_world_idrequired
null
iconic_horizon_world_namerequired
null
iconic_horizon_world_thumbnail_img_urlrequired
null
is_wearable_media_producerrequired
boolean
pivot_page_micro_user_dictrequired
null
world_location_pages_inforequired
null
media_ui_attributions_data_v2optional
array
cursorrequired
string
has_morerequired
boolean