GET/v1/results

Get Results

Retrieve scraped Instagram posts data from your squid

Retrieve Instagram posts data from your completed scraping tasks. The scraper extracts comprehensive post information including captions, engagement metrics, media URLs, comments, and metadata.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Post Information

url
string
Full Instagram post URL
Example: https://www.instagram.com/p/ABC123/
post_id
string
Unique Instagram post ID
Example: 3769351289982373597
shortcode
string
Post shortcode used in URL
Example: DRPbQcBD07d
caption
string
Post caption text
Example: Amazing sunset at the beach! #sunset #nature
alt
string
Alt text / accessibility description
Example: Photo by National Geographic on January 06, 2026

Owner Information

owner_username
string
Username of post owner
Example: natgeo
owner_full_name
string
Full display name of post owner
Example: National Geographic
owner_id
string
Instagram user ID of post owner
Example: 787132

Engagement Metrics

likes_count
integer
Number of likes on the post
Example: 150000
comments_count
integer
Number of comments on the post
Example: 2500

Timestamps

timestamp
bigint
Unix timestamp of when post was created
Example: 1640000000
timestamp_datetime
datetime
ISO 8601 formatted datetime of post creation
Example: 2026-01-06T12:00:00+02:00

Post Type & Status

product_type
string
Type of post (feed, carousel_container, clips, igtv)
Example: carousel_container
media_type
string
Media type (image, video, carousel)
Example: carousel
is_pinned
boolean
Whether the post is pinned to profile
Example: false
is_paid_partnership
boolean
Whether post is a paid partnership/sponsored content
Example: false

Media URLs

display_url
string
Main image/thumbnail URL
Example: https://example.com/image.jpg
video_url
string
Video URL (for video posts)
Example: https://example.com/video.mp4
reel_url
string
Reel URL (for reel posts)
Example: https://www.instagram.com/reel/ABC123/
dimensions
string
Media dimensions (width x height)
Example: 1080x1350
image_1
string
First carousel image URL
Example: https://example.com/carousel/1.jpg
image_2
string
Second carousel image URL
Example: https://example.com/carousel/2.jpg
image_3
string
Third carousel image URL
Example: https://example.com/carousel/3.jpg
image_4
string
Fourth carousel image URL
Example: https://example.com/carousel/4.jpg
image_5
string
Fifth carousel image URL
Example: https://example.com/carousel/5.jpg

Carousel Media

carousel_media_count
integer
Number of media items in carousel
Example: 3
child_post_1
object
First carousel item with id, media_type, display_url/video_url, dimensions
Example: {id: 123, media_type: 1, display_url: ..., height: 1350, width: 1080}
child_post_2
object
Second carousel item
Example: {}
child_post_3
object
Third carousel item
Example: {}
child_post_4 - child_post_10
object
Additional carousel items (up to 10)
Example: {}

Tags, Hashtags & Music

hashtags
array
Array of hashtags used in the post
Example: [#sunset, #nature, #photography]
user_tags
array
Array of tagged users with pk, username, full_name, profile_pic_url, is_verified
Example: [{pk: 123, username: tagged_user, ...}]
coauthors
array
Array of co-authors for collaborative posts
Example: [{pk: 123, username: coauthor1, full_name: Co Author, ...}]
music
object
Music/audio information for reels
Example: {audio_cluster_id: 123, title: Song Title, display_artist: Artist Name, ...}

Comments

comment_1
object
First comment with comment_id, text, created_at, user info
Example: {comment_id: 123, text: Great post!, created_at: 1640000000, user: {user_id: 456, username: commenter1}}
comment_2 - comment_15
object
Additional comments (up to 15 total)
Example: {}

Metadata

scraping_time
datetime
When the data was scraped
Example: 2026-01-13T10:30:00+02:00
functions
object
Internal function metadata
Example: {}

Parameters

squidstring
Required
Hash of the squid to get results from
Example: YOUR_SQUID_HASH
runstring
Optional
Hash of a specific run (optional, filters to that run only)
Example: RUN_HASH
pageinteger
Optional
Page number (default: 1)
Example: 1
page_sizeinteger
Optional
Results per page (default: 50, max: 100)
Example: 50
Pro Tip

Pro Tip

Use `timestamp_datetime` for easy date filtering and sorting of posts by publication time.
Note

Note

Carousel posts include up to 10 child items with individual media URLs in `child_post_1` through `child_post_10`.
Pro Tip

Pro Tip

Check `is_paid_partnership` to identify sponsored content and influencer collaborations.
Pro Tip

Pro Tip

The `hashtags` array is useful for content categorization and trend analysis.