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
photos
string[]
videos
string[]
thumbnail
string
display_url
string
audio
string | null