Instagram

This source is based on Media from Personal and Business Instagram accounts. A Personal account will allow you to display the images from your own Instagram account, but not from any of the Facebook pages you manage. The Professional account will instead allow you to display media from Facebook pages associated (opens new window) with an Instagram account, but not any of your Personal ones. If you have both, simply create two or more sources.

Once the source has been created, as instructed in the Getting Started guide, you will be able to map its contents to any Builder element.

The cache is set to 3600 seconds by default, if your workflow requires immediate results disable the cache by setting it to 0, but being this an API-driven source it is not recommended.

TIP

This source requires granting permission to the ZOOlanders OAuth App, but you can also create your Facebook App and use it instead.

Queries

The following source queries are supported out of the box, although the Instagram API (opens new window) might allow further integration.

Media Query

Retrieves all photo and video IG Media objects of the authenticated User account or Page associated to a Business account.

Hashtagged Media Query

Business Accounts Only. Retrieves a collection of the most recently published or the most popular photo and video IG Media objects that have been tagged with a hashtag.

Types

Media Type

Each query returns a, or a list of, Media Type which has the following available properties for mapping.

Name	Type	Description
Media Type	String	Can be CAROUSEL_ALBUM, IMAGE, or VIDEO.
Media Url	String	The Media Url, locally cached the first time is accessed.
Media Thumbnail Url	String	The Media Thumbnail Url, locally cached the first time is accessed.
Caption	String	The caption content.
Permalink	String	Permanent URL to the media.
Timestamp	String	ISO 8601-formatted creation date in UTC (default is UTC ±00:00).
Username	String	Username of user who created the media.
Hashtags	String	Media hashtags listed with a custom separator.
Hashtags	ListOf	Media hashtags available as a multi item content with an id and name available for mapping.
Comments Count	Int	Total of comments (Business accounts only).
Like Count	Int	Total of likes (Business accounts only).