Сначала — общие слова об API инстаграма.

API построено по принципу RESTful, т.е. ответы на запросы в формате JSON. Есть ограничение на темп запросов — не выше 5 тысяч запросов в час, таким образом один запрос в секунду будет гарантированно допустимым пределом.

Каждый ответ состоит из полей meta (общая информация о статусе запроса), data (запрошенные данные) и, если все данные не влезли в одну страницу, pagination с адресом следующей страницы данных.

Практически во всех запросах можно регулировать количество полей данных с помощью параметра count.

Перед выполнением запросов нужно настроить привилегии доступа.

Пользователи

GET http://api.instagram.com/v1/users/user-id/ — информация о пользователе

GET http://api.instagram.com/v1/users/self/feed/ — лента пользователя

GET http://api.instagram.com/v1/users/user-id/media/recent/ — свежие фотографии пользователя

GET http://api.instagram.com/v1/users/self/media/liked/ — фотографии, которые лайкнул юзер

GET http://api.instagram.com/v1/users/search/?q=name — поиск пользователя по нику

Связи

GET http://api.instagram.com/v1/users/user-id/follows/ — список фолловеров юзера

GET http://api.instagram.com/v1/users/user-id/followed-by/ — список подписчиков на юзера

GET http://api.instagram.com/v1/users/self/requested-by/ — список желающих фолловить юзера

GET http://api.instagram.com/v1/users/user-id/relationship/ — информация о взаимоотношениях с пользователем user-id

POST http://api.instagram.com/v1/users/user-id/relationship/** — изменить взаимоотношения с пользователем user-id

Фотографии

GET http://api.instagram.com/v1/media/media-id/ — информация о фотографии

GET http://api.instagram.com/v1/media/search/ — поиск фотографий, сделанных недалеко от определённого места

GET http://api.instagram.com/v1/media/popular/ — поиск популярных фотографий

Комментарии

GET http://api.instagram.com/v1/media/media-id/comments/ — список комментариев к фотографии

POST http://api.instagram.com/v1/media/media-id/comments/ — послать комментарий к фотографии. Доступно только по запросу.

DEL http://api.instagram.com/v1/media/media-id/comments/comment-id/ — удалить свой комментарий к фотографии.

Лайки

GET http://api.instagram.com/v1/media/media-id/likes/ – список лайков к фотографии

POST http://api.instagram.com/v1/media/media-id/likes/ – лайкнуть фотографию

DEL http://api.instagram.com/v1/media/media-id/likes/ – удалить свой лайк к фотографии

Теги

GET http://api.instagram.com/v1/tags/tag-name/ – информация о теге

GET http://api.instagram.com/v1/tags/tag-name/media/recent/ – список последниx фотографий с тегом

GET http://api.instagram.com/v1/tags/search/?q=name – поиск тегов

Места

GET http://api.instagram.com/v1/locations/location-id/ – информация о месте

GET http://api.instagram.com/v1/locations/location-id**/media/recent/ **- список последниx фотографий с места

GET http://api.instagram.com/v1/locations/search/?q=name – поиск мест по координатам или по id форсквера.

География

GET http://api.instagram.com/v1/geographies/{geo-id}/media/recent/ – список последних фотографий с точки с определёнными координатами.