Tagged Posts

GET/v1/instagram/user/tagged-posts1 credit

Lists the posts in which an account has been tagged.

01Query parameters

Name	Type	Description
user_idrequired	string	Numeric Instagram user id, e.g. `787132`.
cursoroptional	string	Cursor for the next page: the `cursor` value of the previous answer.

02Request

curl "https://api.scrapesocial.ai/v1/instagram/user/tagged-posts?user_id=787132" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/instagram/user/tagged-posts?user_id=787132

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "posts": [
    {
      "pk": "1929261108986102451",
      "media_type": 1,
      "code": "BrGHMHIF8Kz",
      "id": "1929261108986102451_429173",
      "accessibility_caption": null,
      "caption": {
        "pk": "18006729967037433",
        "text": "Vardzia is a cave monastery site located in southern Georgia. It is excavated from the slopes of the Erusheti Mountain on the left side of the Kura River. Oh Georgia, I miss you when I look at these images 😭 #georgia #exploregeorgia #MavicPro\n.\n.\n.\n.\n.\n#mymavic #awesome_earthpix #collectivelycreate #exploretocreate #livefolk #beautifuldestinations #iglifecz #folkcreative #exklusive_shot #AGameOfTo…"
      },
      "audience": null,
      "carousel_media_count": null,
      "display_uri": null,
      "carousel_media": null,
      "image_versions2": {
        "candidates": [
          {
            "height": 1334,
            "url": "https://instagram.fadb3-1.fna.fbcdn.net/v/t51.82787-15/640956567_18562047613037433_6822966074348684895_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ig_cache_key=MTkyOTI2MTEwODk4NjEwMjQ1MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=uLsOxfYP6PMQ7kNvwGE2BQ_&_nc_oc=Ado9KByNBZ091qd-MPvRcpDUXzuMxivTiMgI8l-…",
            "width": 1080
          },
          {
            "height": 889,
            "url": "https://instagram.fadb3-1.fna.fbcdn.net/v/t51.82787-15/640956567_18562047613037433_6822966074348684895_n.jpg?stp=dst-jpg_e35_p720x720_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ig_cache_key=MTkyOTI2MTEwODk4NjEwMjQ1MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=uLsOxfYP6PMQ7kNvwGE2BQ_&_nc_oc=Ado9KByNBZ091qd-MPvRcpDUXzuMxi…",
            "width": 720
          }
        ]
      },
      "media_cropping_info": null,
      "profile_grid_thumbnail_fitting_style": null,
      "media_overlay_info": null,
      "preview": null,
      "product_type": "feed",
      "thumbnails": null,
      "timeline_pinned_user_ids": [],
      "upcoming_event": null,
      "user": {
        "pk": "429173",
        "username": "hynecheck",
        "id": "429173"
      },
      "media_notes": null,
      "like_count": 14039,
      "like_and_view_counts_disabled": false,
      "boosted_status": null,
      "boost_unavailable_identifier": null,
      "boost_unavailable_reason": null,
      "comment_count": 583,
      "comments_disabled": null,
      "view_count": null,
      "original_height": 1334,
      "original_width": 1080,
      "ai_interactive_embodiment_attachment_style_info": null,
      "__typename": "XDTMediaDict",
      "url": "https://www.instagram.com/p/BrGHMHIF8Kz/"
    },
    {
      "pk": "1929229904589027835",
      "media_type": 1,
      "code": "BrGAGBxFvn7",
      "id": "1929229904589027835_276524869",
      "accessibility_caption": null,
      "caption": {
        "pk": "17989037887125917",
        "text": "No helmet needed once your on Cát Bà Island.\n.\nCát Bà Island || Vietnam\n.\n.\n.\n.\n.\n.\n.\n.\n.\n.\n.\n.\n.\n.\nShot on EOS T3i and SIGMA 85mm F1.4 EX DG HSM\nISO 100 | f/1.4 | 1/2000\n——\n#vietnam #vietnamese #vietnamesefood #vietnamflashback #vietnamesegirl #vietnamtravel #vietnamtrip #vietnamesehair #vietnamwar #vietnamesecuisine #vietnamflashbacks #vietnamesecoffee #vietnamfood #Canon #canonphotography #cano…"
      },
      "audience": null,
      "carousel_media_count": null,
      "display_uri": null,
      "carousel_media": null,
      "image_versions2": {
        "candidates": [
          {
            "height": 720,
            "url": "https://instagram.fadb3-2.fna.fbcdn.net/v/t51.82787-15/630462428_18409600975125917_7503154876014188463_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ig_cache_key=MTkyOTIyOTkwNDU4OTAyNzgzNQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=DENTzECju-0Q7kNvwF_3Djj&_nc_oc=AdoZNhoyVsv56II4WpbephfVJmPd8pfSvFqkOD4…",
            "width": 1080
          },
          {
            "height": 480,
            "url": "https://instagram.fadb3-2.fna.fbcdn.net/v/t51.82787-15/630462428_18409600975125917_7503154876014188463_n.jpg?stp=dst-jpg_e35_s720x720_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ig_cache_key=MTkyOTIyOTkwNDU4OTAyNzgzNQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=DENTzECju-0Q7kNvwF_3Djj&_nc_oc=AdoZNhoyVsv56II4WpbephfVJmPd8p…",
            "width": 720
          }
        ]
      },
      "media_cropping_info": null,
      "profile_grid_thumbnail_fitting_style": null,
      "media_overlay_info": null,
      "preview": null,
      "product_type": "feed",
      "thumbnails": null,
      "timeline_pinned_user_ids": [],
      "upcoming_event": null,
      "user": {
        "pk": "276524869",
        "username": "samuellemieux",
        "id": "276524869"
      },
      "media_notes": null,
      "like_count": 6178,
      "like_and_view_counts_disabled": false,
      "boosted_status": null,
      "boost_unavailable_identifier": null,
      "boost_unavailable_reason": null,
      "comment_count": 180,
      "comments_disabled": null,
      "view_count": null,
      "original_height": 720,
      "original_width": 1080,
      "ai_interactive_embodiment_attachment_style_info": null,
      "__typename": "XDTMediaDict",
      "url": "https://www.instagram.com/p/BrGAGBxFvn7/"
    }
  ],
  "cursor": "1928438992669758833",
  "has_more": true
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

10 posts per page in `posts`; pass `cursor` back while `has_more` is true. `display_uri` is always null. An unknown id and a private account both give an empty list for 0 credits (they cannot be told apart). A non-numeric id is a free 400. This route can briefly answer a free 503 when it is temporarily unavailable.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.