Skip to main content
POST
/
posts
/
collect
cURL
curl -X POST "https://api.brightdata.com/posts/collect" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/p/POST_ID/"}'
{
  "post_id": "POST_ID",
  "description": "Exploring the world 🌍",
  "hashtags": [
    "travel",
    "nature"
  ],
  "date_posted": "2024-01-10",
  "num_comments": 542,
  "likes": 10234,
  "content_type": "image",
  "video_view_count": null,
  "video_play_count": null,
  "user_posted": "natgeo",
  "followers": 282000000,
  "profile_url": "https://www.instagram.com/natgeo/",
  "profile_image_link": "https://instagram.fxyz1-1.fna.fbcdn.net/profile.jpg",
  "photos": [
    "https://cdn.instagram.com/photo1.jpg"
  ],
  "videos": [],
  "thumbnail": "https://cdn.instagram.com/thumb.jpg",
  "display_url": "https://instagram.com/p/POST_ID/",
  "audio": null
}
The Posts API allows you to collect and discover Instagram posts from individual post URLs or public profile URLs.

​
Collect by URL

This endpoint allows users to collect detailed data from a single Instagram post by providing the post URL.

​
Input Parameters

​
URL
string
required
The Instagram post URL.

​
Output Structure

Includes detailed post, profile, and media data. Post details
  • post_id
  • description
  • hashtags
  • date_posted
  • num_comments
  • likes
  • content_type
  • video_view_count
  • video_play_count
  • and more
For the full list of fields,
View complete output reference
Page and profile details
  • user_posted
  • followers
  • posts_count
  • profile_image_link
  • is_verified
  • profile_url
We provide a limited set of data points about the profile.
Attachments and media
  • photos
  • videos
  • thumbnail
  • display_url (link only, not the file itself)
  • audio

​
Discover by URL

This endpoint allows users to discover recent Instagram posts from a public profile by providing the profile URL and optional filtering parameters.

​
Input Parameters

​
URL
string
required
The Instagram profile URL.
​
num_of_posts
number
The number of recent posts to collect. If omitted, there is no limit.
​
posts_to_not_include
array
Array of post IDs to exclude from the results.
​
start_date
string
Start date for filtering posts in MM-DD-YYYY format (must be earlier than end_date).
​
end_date
string
End date for filtering posts in MM-DD-YYYY format (must be later than start_date).
​
post_type
string
Specify the type of posts to collect (for example, post or reel).

​
Output Structure

Includes detailed post, profile, and media information. Post details
  • post_id
  • description
  • hashtags
  • date_posted
  • num_comments
  • likes
  • video_view_count
  • video_play_count
  • and more
For the full list of fields,
View complete output reference
Page and profile details
  • user_posted
  • followers
  • posts_count
  • profile_image_link
  • is_verified
  • profile_url
  • is_paid_partnership
  • partnership_details
  • user_posted_id
Attachments and media
  • photos
  • videos
  • thumbnail
  • audio
  • display_url
  • content_type
  • product_type
  • coauthor_producers
  • tagged_users
This endpoint supports advanced post discovery using filters, exclusions, and post type selection, making it suitable for analytics and large-scale data collection.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
url
string<uri>
required

Instagram post URL

Response

Post data collected successfully

​
post_id
string
​
description
string
​
hashtags
string[]
​
date_posted
string
​
num_comments
integer
​
likes
integer
​
content_type
string
​
video_view_count
integer | null
​
video_play_count
integer | null
​
user_posted
string
​
followers
integer
​
profile_url
string
​
profile_image_link
string
​
photos
string[]
​
videos
string[]
​
thumbnail
string
​
display_url
string
​
audio
string | null