Social API — Instagram by user id


This method will return data about posts a user has made on instagram.

Definition

GET http://social.api.condenet.co.uk/instagram/user/<username>


Query Parameters

min_id and max_id are supported query string parameters. These control pagination, and can be found in data.items.[] within the response from the API.

Example request

$ curl http://social.api.condenet.co.uk/instagram/user/theworldofinteriors

Example response

Please note this response is truncated
{
  "data": {
    "items": [
      {
        "alt_media_url": null,
        "can_delete_comments": false,
        "can_view_comments": true,
        "caption": {
          "created_time": "1472822988",
          "from": {
            "full_name": "The World of Interiors",
            "id": "1046805",
            "profile_picture": "https://scontent.cdninstagram.com/t51.2885-19/s150x150/12543175_161366177567394_421412876_a.jpg",
            "username": "theworldofinteriors"
          },
          "id": "17851863748100624",
          "text": "#thatfeelingwhen you and your #squad have got your #fridaycasual vibe #matchymatchy and #onfleek \ud83d\ude4c\ud83c\udffb\ud83d\udc54 #squadgoals \ud83d\udd25"
        },
        ...
      }
    ]
  }
}

Error handling

If the given username is not recognised by Instagram, a 404 response will be returned.

Example error response

{
  "error": "Instagram user does not exist"
}

If Instagram themselves encounter an error, the following response will be returned along with the HTTP code instagram returned to the social api. You should very rarely see this type of error.

Example error response

{
  "error": "Error response from Instagram"
}