-
Notifications
You must be signed in to change notification settings - Fork 858
Version 2 migration guide
Steven Schobert edited this page Mar 30, 2020
·
6 revisions
Quite a few things have changed with the switch to Instagram's new API. The amount of information the new API provides about images and videos is greatly reduced. As a result, some options in v1 are no longer available in v2.
v2 provides a much simpler service, but should still cater to the most common use-case for Instafeed: embedding my most recent Instagram posts on my website.
- Media is generally only available from the user that the access token belongs to. (You can only display your own posts)
- Geographic/location information is not available
- Searching by tag is not available
- Information on likes and comments is not available
- Most sorting options are removed - only sort by name, date is available
- An access token refresh service is required. See Managing Access Tokens for more info.
These are the v1 options and their status in v2:
Key | Status | Notes |
---|---|---|
accessToken | Required, Updated | The accessToken from the Facebook App associated with the user. Needs to be retrieved from a token service. More info |
after | Optional | Works as v1 |
before | Optional | Works as v1 |
Removed | Basic display API only supports getting the user's own media. | |
error | Optional | Works as v1 |
filter | Optional | Works as v1 |
Removed | No longer supported by Basic Display API | |
limit | Optional, Updated | Maximum number of media items to add to the page. This limit is applied in the browser. Basic Display API limits are unclear. |
Removed | Links are included by default. Use the template option to control this instead. | |
Removed | No longer supported by Basic Display API | |
mock | Optional | Works as v1 |
Removed | A single image resolution is returned by the Basic Display API. This is generally high resolution - 1440px wide is typical. | |
sortBy | Removed | Replaced by the new sort option, which uses a function. Sorting is performed in the browser. |
success | Optional | Works as v1 |
Removed | No longer supported by Basic Display API. Use filter instead |
|
target | Optional | Either the ID name or the DOM element itself where you want to add the images to. |
template | Optional, Updated | Custom HTML template to render media. See templating. |
Removed | All URLs are HTTPS only | |
Removed | No longer supported by Basic Display API |
See the full v2 options reference