Instagram User Posts (V1) API

Retrieve recent posts from an Instagram account by supplying the target user_id. Supports pagination via cursor parameters to browse historical media feeds.

Use cases

• Display an Instagram account media feed in an external application.
• Monitor engagement metrics such as likes and comments over recent posts.
• Archive captions and post metadata for specific public profiles.

Request

curl -X POST "https://api.sandbase.ai/v1/api/instagram/v1/user-posts" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "25025320"}'

Parameters

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "items": [
    {
      "caption_is_edited": false,
      "coauthor_producer_can_see_organic_insights": false,
      "comment_count": 18380,
      "device_timestamp": 1790870048722622,
      "disable_caption_and_comment": false,
      "filter_type": 0,
      "id": "3998430248382584993_25025320",
      "ig_play_count": 150975683,
      "like_and_view_counts_disabled": false,
      "like_count": 642777,
      "caption": {
        "content_type": "comment",
        "media_id": 3998430248382584993,
        "private_reply_status": 0,
        "status": "Active",
        "text": "DIY fish squishy 🐟⁣ ⁣ @yano4kaa.a made this squishy using stuff she already had at home l…",
        "text_translation": "DIY fish squishy 🐟     @yano4kaa.a made this squishy using stuff she already had at home …"
      },
      "clips_metadata": {
        "audio_type": "licensed_music",
        "music_canonical_id": "18242041438023387",
        "professional_clips_upsell_type": 0
      },
      "user": {
        "account_type": 3,
        "eligible_for_text_app_activation_badge": false,
        "full_name": "Instagram",
        "id": "25025320",
        "pk_id": "25025320",
        "profile_pic_id": "3725434617063385984_25025320"
      }
    }
  ]
}

Notes

• Supply user_id to identify the Instagram profile.
• Pass max_id as the pagination cursor for requests after the first page.
• Use count to specify the number of posts returned per page, defaulting to 12.

Related APIs

• Instagram Cities by Country: Returns a list of Instagram cities and regions for a specified country code.
• Instagram Hashtag Posts (V1): Returns public Instagram posts associated with a specific hashtag.
• Instagram Location Details (V1): Returns detailed metadata and profile information for a specified Instagram location using its unique identifier.