org.apache.streams.instagram.api

Interface Media

All Known Implementing Classes:

Instagram

public interface Media

Media Endpoints. Comments Endpoints. Like Endpoints.

See Also:

https://www.instagram.com/developer/endpoints/media/, https://www.instagram.com/developer/endpoints/comments/, https://www.instagram.com/developer/endpoints/likes/

Method Summary

Modifier and Type	Method and Description
CommentsResponse	comments(String media_id) Get a list of recent comments on a media object.
UsersInfoResponse	likes(String media_id) Get a list of users who have liked this media.
MediaResponse	lookupMedia(String media_id) Get information about a media object.
SearchMediaResponse	searchMedia(SearchMediaRequest parameters) Search for recent media in a given area.
MediaResponse	shortcode(String shortcode) This endpoint returns the same response as GET /media/media-id.

Method Detail

comments

CommentsResponse comments(String media_id)

Get a list of recent comments on a media object. The public_content scope is required for media that does not belong to the owner of the access_token.

Parameters:

media_id - media_id

Returns:

CommentsResponse @link{CommentsResponse}

See Also:

https://www.instagram.com/developer/endpoints/comments/#get_media_comments

likes

UsersInfoResponse likes(String media_id)

Get a list of users who have liked this media. The public_content scope is required for media that does not belong to the owner of the access_token.

Parameters:

media_id - media_id

Returns:

UsersInfoResponse @link{UsersInfoResponse}

See Also:

https://www.instagram.com/developer/endpoints/likes/#get_media_likes

lookupMedia

MediaResponse lookupMedia(String media_id)

Get information about a media object. Use the type field to differentiate between image and video media in the response. You will also receive the user_has_liked field which tells you whether the owner of the access_token has liked this media. The public_content permission scope is required to get a media that does not belong to the owner of the access_token.

Parameters:

media_id - media_id

Returns:

MediaResponse @link{MediaResponse}

See Also:

https://www.instagram.com/developer/endpoints/media/#get_media

shortcode

MediaResponse shortcode(String shortcode)

This endpoint returns the same response as GET /media/media-id. A media object's shortcode can be found in its shortlink URL. An example shortlink is http://instagram.com/p/tsxp1hhQTG/. Its corresponding shortcode is tsxp1hhQTG.

Parameters:

shortcode - shortcode

Returns:

MediaResponse @link{MediaResponse}

See Also:

https://www.instagram.com/developer/endpoints/media/#get_media_by_shortcode

searchMedia

SearchMediaResponse searchMedia(SearchMediaRequest parameters)

Search for recent media in a given area.

Parameters:

parameters - @link{SearchMediaRequest}

Returns:

SearchMediaResponse @link{SearchMediaResponse}

See Also:

https://www.instagram.com/developer/endpoints/media/#get_media_search