Bridgly SDK
import { Bridgly } from '@bridgly/sdk';
const client = new Bridgly({ apiKey: process.env.BRIDGLY_API_KEY });
const res = await client.instagram.getTrendingReels({
count: 10,
});
if (res.type === 'success') console.log(res.data);curl --request POST \
--url https://api.bridgly.app/instagram/trending-reels \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"count": 10,
"cursor": "<string>",
"cacheMaxAgeHours": 123,
"cacheOnly": true
}
'import requests
url = "https://api.bridgly.app/instagram/trending-reels"
payload = {
"count": 10,
"cursor": "<string>",
"cacheMaxAgeHours": 123,
"cacheOnly": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({count: 10, cursor: '<string>', cacheMaxAgeHours: 123, cacheOnly: true})
};
fetch('https://api.bridgly.app/instagram/trending-reels', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bridgly.app/instagram/trending-reels",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'count' => 10,
'cursor' => '<string>',
'cacheMaxAgeHours' => 123,
'cacheOnly' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bridgly.app/instagram/trending-reels"
payload := strings.NewReader("{\n \"count\": 10,\n \"cursor\": \"<string>\",\n \"cacheMaxAgeHours\": 123,\n \"cacheOnly\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bridgly.app/instagram/trending-reels")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"count\": 10,\n \"cursor\": \"<string>\",\n \"cacheMaxAgeHours\": 123,\n \"cacheOnly\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bridgly.app/instagram/trending-reels")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"count\": 10,\n \"cursor\": \"<string>\",\n \"cacheMaxAgeHours\": 123,\n \"cacheOnly\": true\n}"
response = http.request(request)
puts response.read_body{
"timeMs": 123,
"creditsCost": 123,
"cachedAt": "2023-11-07T05:31:56Z",
"data": {
"nextCursor": "<string>",
"posts": [
{
"id": "<string>",
"type": "Image",
"display_url": "<string>",
"video_url": "<string>",
"width": 123,
"height": 123,
"video_duration": 123,
"accessibility_caption": "<string>",
"image_versions": [
{
"url": "<string>",
"width": 123,
"height": 123
}
],
"video_versions": [
{
"url": "<string>",
"width": 123,
"height": 123,
"type": 123
}
],
"has_audio": true,
"video_dash_manifest": "<string>",
"number_of_qualities": 123,
"carousel_parent_id": "<string>",
"user_tags": [
{
"user": {
"id": "<string>",
"username": "<string>",
"full_name": "<string>",
"profile_pic_url": "<string>",
"is_private": true,
"is_verified": true,
"profile_pic_id": "<string>",
"latest_reel_media": 123,
"is_mentionable": true
},
"position": [
123
]
}
],
"shortcode": "<string>",
"url": "<string>",
"caption": "<string>",
"likes": 123,
"comments": 123,
"timestamp": 123,
"is_video": true,
"video_view_count": 123,
"owner": {
"id": "<string>",
"username": "<string>",
"full_name": "<string>",
"profile_pic_url": "<string>",
"is_private": true,
"is_verified": true,
"profile_pic_id": "<string>",
"latest_reel_media": 123,
"is_mentionable": true
},
"carousel_media": [
{
"id": "<string>",
"type": "Image",
"display_url": "<string>",
"video_url": "<string>",
"width": 123,
"height": 123,
"video_duration": 123,
"accessibility_caption": "<string>",
"image_versions": [
{
"url": "<string>",
"width": 123,
"height": 123
}
],
"video_versions": [
{
"url": "<string>",
"width": 123,
"height": 123,
"type": 123
}
],
"has_audio": true,
"video_dash_manifest": "<string>",
"number_of_qualities": 123,
"carousel_parent_id": "<string>",
"user_tags": [
{
"user": {
"id": "<string>",
"username": "<string>",
"full_name": "<string>",
"profile_pic_url": "<string>",
"is_private": true,
"is_verified": true,
"profile_pic_id": "<string>",
"latest_reel_media": 123,
"is_mentionable": true
},
"position": [
123
]
}
]
}
],
"caption_id": "<string>",
"caption_created_at": 123,
"caption_is_edited": true,
"caption_has_translation": true,
"product_type": "<string>",
"play_count": 123,
"comments_disabled": true,
"like_and_view_counts_disabled": true,
"is_paid_partnership": true,
"coauthors": [
{
"id": "<string>",
"username": "<string>",
"full_name": "<string>",
"profile_pic_url": "<string>",
"is_private": true,
"is_verified": true,
"profile_pic_id": "<string>",
"latest_reel_media": 123,
"is_mentionable": true
}
],
"pinned_user_ids": [
"<string>"
],
"carousel_media_count": 123,
"location": {
"id": "<string>",
"url": "<string>",
"name": "<string>",
"slug": "<string>",
"latitude": 123,
"longitude": 123,
"category": "<string>",
"posts_count": 123,
"address": "<string>",
"city": "<string>",
"postal_code": "<string>",
"phone": "<string>",
"price_range": 123,
"hours_status": "<string>"
},
"audio": {
"id": "<string>",
"url": "<string>",
"type": "<string>",
"title": "<string>",
"artist": "<string>"
},
"shares": 123,
"reposts": 123,
"top_likers": [
"<string>"
],
"ai_label": {
"text": "<string>",
"detection_method": "<string>",
"is_self_disclosed": true
}
}
]
}
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}Instagram
List trending Reels
List the Reels Instagram’s Reels tab is recommending right now, with captions, media links, publish times, engagement counts, owner details and the audio each one uses. Continue with nextCursor. Recommendations change between requests. Costs 1 credit per request.
POST
/
instagram
/
trending-reels
Bridgly SDK
import { Bridgly } from '@bridgly/sdk';
const client = new Bridgly({ apiKey: process.env.BRIDGLY_API_KEY });
const res = await client.instagram.getTrendingReels({
count: 10,
});
if (res.type === 'success') console.log(res.data);curl --request POST \
--url https://api.bridgly.app/instagram/trending-reels \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"count": 10,
"cursor": "<string>",
"cacheMaxAgeHours": 123,
"cacheOnly": true
}
'import requests
url = "https://api.bridgly.app/instagram/trending-reels"
payload = {
"count": 10,
"cursor": "<string>",
"cacheMaxAgeHours": 123,
"cacheOnly": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({count: 10, cursor: '<string>', cacheMaxAgeHours: 123, cacheOnly: true})
};
fetch('https://api.bridgly.app/instagram/trending-reels', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bridgly.app/instagram/trending-reels",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'count' => 10,
'cursor' => '<string>',
'cacheMaxAgeHours' => 123,
'cacheOnly' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bridgly.app/instagram/trending-reels"
payload := strings.NewReader("{\n \"count\": 10,\n \"cursor\": \"<string>\",\n \"cacheMaxAgeHours\": 123,\n \"cacheOnly\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bridgly.app/instagram/trending-reels")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"count\": 10,\n \"cursor\": \"<string>\",\n \"cacheMaxAgeHours\": 123,\n \"cacheOnly\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bridgly.app/instagram/trending-reels")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"count\": 10,\n \"cursor\": \"<string>\",\n \"cacheMaxAgeHours\": 123,\n \"cacheOnly\": true\n}"
response = http.request(request)
puts response.read_body{
"timeMs": 123,
"creditsCost": 123,
"cachedAt": "2023-11-07T05:31:56Z",
"data": {
"nextCursor": "<string>",
"posts": [
{
"id": "<string>",
"type": "Image",
"display_url": "<string>",
"video_url": "<string>",
"width": 123,
"height": 123,
"video_duration": 123,
"accessibility_caption": "<string>",
"image_versions": [
{
"url": "<string>",
"width": 123,
"height": 123
}
],
"video_versions": [
{
"url": "<string>",
"width": 123,
"height": 123,
"type": 123
}
],
"has_audio": true,
"video_dash_manifest": "<string>",
"number_of_qualities": 123,
"carousel_parent_id": "<string>",
"user_tags": [
{
"user": {
"id": "<string>",
"username": "<string>",
"full_name": "<string>",
"profile_pic_url": "<string>",
"is_private": true,
"is_verified": true,
"profile_pic_id": "<string>",
"latest_reel_media": 123,
"is_mentionable": true
},
"position": [
123
]
}
],
"shortcode": "<string>",
"url": "<string>",
"caption": "<string>",
"likes": 123,
"comments": 123,
"timestamp": 123,
"is_video": true,
"video_view_count": 123,
"owner": {
"id": "<string>",
"username": "<string>",
"full_name": "<string>",
"profile_pic_url": "<string>",
"is_private": true,
"is_verified": true,
"profile_pic_id": "<string>",
"latest_reel_media": 123,
"is_mentionable": true
},
"carousel_media": [
{
"id": "<string>",
"type": "Image",
"display_url": "<string>",
"video_url": "<string>",
"width": 123,
"height": 123,
"video_duration": 123,
"accessibility_caption": "<string>",
"image_versions": [
{
"url": "<string>",
"width": 123,
"height": 123
}
],
"video_versions": [
{
"url": "<string>",
"width": 123,
"height": 123,
"type": 123
}
],
"has_audio": true,
"video_dash_manifest": "<string>",
"number_of_qualities": 123,
"carousel_parent_id": "<string>",
"user_tags": [
{
"user": {
"id": "<string>",
"username": "<string>",
"full_name": "<string>",
"profile_pic_url": "<string>",
"is_private": true,
"is_verified": true,
"profile_pic_id": "<string>",
"latest_reel_media": 123,
"is_mentionable": true
},
"position": [
123
]
}
]
}
],
"caption_id": "<string>",
"caption_created_at": 123,
"caption_is_edited": true,
"caption_has_translation": true,
"product_type": "<string>",
"play_count": 123,
"comments_disabled": true,
"like_and_view_counts_disabled": true,
"is_paid_partnership": true,
"coauthors": [
{
"id": "<string>",
"username": "<string>",
"full_name": "<string>",
"profile_pic_url": "<string>",
"is_private": true,
"is_verified": true,
"profile_pic_id": "<string>",
"latest_reel_media": 123,
"is_mentionable": true
}
],
"pinned_user_ids": [
"<string>"
],
"carousel_media_count": 123,
"location": {
"id": "<string>",
"url": "<string>",
"name": "<string>",
"slug": "<string>",
"latitude": 123,
"longitude": 123,
"category": "<string>",
"posts_count": 123,
"address": "<string>",
"city": "<string>",
"postal_code": "<string>",
"phone": "<string>",
"price_range": 123,
"hours_status": "<string>"
},
"audio": {
"id": "<string>",
"url": "<string>",
"type": "<string>",
"title": "<string>",
"artist": "<string>"
},
"shares": 123,
"reposts": 123,
"top_likers": [
"<string>"
],
"ai_label": {
"text": "<string>",
"detection_method": "<string>",
"is_self_disclosed": true
}
}
]
}
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}Authorizations
Body
application/json
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 <= 9007199254740991Response
Default Response
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))$Was this page helpful?