Instagram API

by Skyler Katz | Last edited: 9/4/2020

Display mode: list

Show Accounts

before_show_accountlist, after_show_accountlist

Here are the tags available to before/after_show_accountlist in the Instagram Accounts list:

Tag Description
__pagination__ The pagination links
__totalpossible__ The total number of items
__totalreturned__ The total number returned in the current request
show_accountlist

Here are the tags available to show in the accounts list view:

Tag Description
__id__ Id of the Instagram Account.
__username__ Username of the Instagram Account
__name__ Name of the Instagram Account
__followerscount__ How many followers the Instagram Account has
__mediacount__ How many posts the Instagram Account has made
__profilepictureurl__ Url to the Instagram Account's profile picture
__biography__ Biography for the Instagram Account
__website__ Website url associated with the Instagram Account
__count__ The current account number in the result set

Show Media

before_show_medialist, after_show_medialist

Here are the tags available to before/after_show_medialist in the Instagram account media list:

Please note that you cannot paginate this list, you can however pass a howmany.

Tag Description
__totalpossible__ The total number of items
__totalreturned__ The total number returned in the current request
__id__ Id of the Instagram Account.
__username__ Username of the Instagram Account
__name__ Name of the Instagram Account
__followerscount__ How many followers the Instagram Account has
__mediacount__ How many posts the Instagram Account has made
__profilepictureurl__ Url to the Instagram Account's profile picture
__biography__ Biography for the Instagram Account
__website__ Website url associated with the Instagram Account
__count__ The current account number in the result set
show_medialist

Here are the tags available to show in the media list view:

Tag Description
__id__ Id of the Instagram media record
__type__ The type of media (IMAGE, VIDEO, ALBUM)
__caption__ The caption of the media record
__likecount__ The total number of likes the record has recieved
__date__ Formattable date/time of when the record was posted to the account. Use __date format='j/m/Y'__.
A complete list of tags is available.
__url__ The Permalink to the Instagram media record
__videourl__ Url to the actual video file (only output if the type is VIDEO)
__imageurl__ The url to the image. If type is VIDEO then this will output the video thumbnail. If the type is ALBUM then this will display the first items image/thumbnail.
Parameters needed to display a list of media records

 

find_account_id

Tells Instagram which account to get a list of media records from

Example:

"find_account_id:101090861674291",

howmany

Sets the maximum number of items to display

Example:

"howmany:3",

Full Example:

$instagram = getContent(
    "instagram",
    "display:list",
    "find_account_id:101090861674291",
    "howmany:2",
    "show_medialist:__caption__",
    "show_medialist:__imageurl__",
    "noecho"
);

Display mode: detail

Show Account

show_accountdetail

Here are the tags available to show in an account detail view:

Tag Description
__id__ Id of the Instagram Account.
__username__ Username of the Instagram Account
__name__ Name of the Instagram Account
__followerscount__ How many followers the Instagram Account has
__mediacount__ How many posts the Instagram Account has made
__profilepictureurl__ Url to the Instagram Account's profile picture
__biography__ Biography for the Instagram Account
__website__ Website url associated with the Instagram Account
__count__ The current account number in the result set
Parameters needed to display a single account record

 

find_account_id

Tells Instagram which account to use

Example:

"find_account_id:101090861674291",

Full Example:

$instagram = getContent(
    "instagram",
    "display:detail",
    "find_account_id:101090861674291",
    "show_accountdetail:__username__",
    "show_accountdetail:__followerscount__",
    "noecho"
);

Show Media

show_mediadetail

Here are the tags available to show in a media detail view:

Tag Description
__id__ Id of the Instagram media record
__type__ The type of media (IMAGE, VIDEO, ALBUM)
__caption__ The caption of the media record
__likecount__ The total number of likes the record has recieved
__date__ Formattable date/time of when the record was posted to the account. Use __date format='j/m/Y'__.
A complete list of tags is available.
__url__ The Permalink to the Instagram media record
__videourl__ Url to the actual video file (only output if the type is VIDEO)
__imageurl__ The url to the image. If type is VIDEO then this will output the video thumbnail. If the type is ALBUM then this will display the first items image/thumbnail.
Parameters needed to display a single media record

 

find_account_id

Tells Instagram which account to use

find_media_id

Tells Instagram which media record to get

Example:

"find_account_id:101090861674291",

"find_media_id:57863548765",

Full Example:

$instagram = getContent(
    "instagram",
    "display:detail",
    "find_account_id:101090861674291",
    "find_media_id:57863548765",
    "show_mediadetail:__imageurl__",
    "show_mediadetail:__caption__",
    "show_mediadetail:__likecount__",
    "noecho"
);

Display mode: album

Show Album

before_show_albumlist, after_show_albumlist

Here are the tags available to before/after_show_albumlist in the Instagram Album display:

Tag Description
__id__ Id of the Instagram media record
__type__ The type of media (IMAGE, VIDEO, ALBUM)
__caption__ The caption of the media record
__likecount__ The total number of likes the record has recieved
__date__ Formattable date/time of when the record was posted to the account. Use __date format='j/m/Y'__.
A complete list of tags is available.
__url__ The Permalink to the Instagram media record
__videourl__ Url to the actual video file (only output if the type is VIDEO)
__imageurl__ The url to the image. If type is VIDEO then this will output the video thumbnail. If the type is ALBUM then this will display the first items image/thumbnail.
__totalreturned__ The total number returned in the current request
show_albumlist

Here are the tags available to show in the album list view:

Tag Description
__id__ Id of the Instagram media record
__type__ The type of media (IMAGE, VIDEO)
__caption__ The caption of the media record
__likecount__ The total number of likes the record has recieved
__date__ Formattable date/time of when the record was posted to the account. Use __date format='j/m/Y'__.
A complete list of tags is available.
__url__ The Permalink to the Instagram media record
__videourl__ Url to the actual video file (only output if the type is VIDEO)
__imageurl__ The url to the image. If type is VIDEO then this will output the video thumbnail.
Parameters needed to display a media album

 

find_account_id

Tells Instagram which account to get a list of media records from

Example:

"find_account_id:101090861674291",

find_media_id

Tells Instagram which media record to get

Example:

"find_media_id:57863548765",

Full Example:

$instagram = getContent(
    "instagram",
    "display:album",
    "find_account_id:101090861674291",
    "find_media_id:57863548765",
    "show_albumlist:__caption__",
    "show_albumlist:__imageurl__",
    "noecho"
);