Feedframer Documentation

Introduction

Feedframer gives you your Instagram posts through a simple API. You connect an Instagram Business or Creator account once, and Feedframer handles the Instagram side: the login, the access tokens, and fetching your posts. Your website or app then reads your posts from Feedframer with a single API key.

What Feedframer does for you

• Connects to Instagram through Instagram's own login, so you never create a Meta developer app
• Refreshes your Instagram access token before it expires
• Fetches your posts on a schedule (daily on Free, hourly on Premium) and stores them
• Copies your images and videos to its own CDN
• Serves your posts as JSON, GraphQL or RSS

Your site's visitors never call Instagram's API, so your traffic can't run into Instagram's limits. Feedframer itself has no rate limits.

When to use Feedframer

• Show your latest Instagram posts on a website or in an app
• Build a gallery or portfolio from your Instagram content
• Add Instagram posts to an email campaign through RSS

API options

Feedframer gives you three ways to read your posts:

• REST API: GET /api/v1/me returns your profile and posts as JSON.
• GraphQL API: POST /graphql with the me query returns just the fields you ask for.
• RSS feed: GET /api/v1/rss returns an RSS 2.0 feed for email tools, feed readers and CMS plugins.

The REST and GraphQL APIs let you:

• filter by post type (IMAGE, VIDEO, CAROUSEL_ALBUM, REELS) and by publish date
• sort by publish date, newest or oldest first
• page through posts with cursors (Premium)

The RSS feed always returns your latest posts, newest first.

Quick example

Every request needs your API key in the api_key query parameter. You'll find the key on your Dashboard. Replace YOUR_API_KEY in the examples below with it.

REST API:

curl 'https://feedframer.com/api/v1/me?api_key=YOUR_API_KEY'

This returns your profile and your latest posts: 6 on Free, up to 100 on Premium.

GraphQL API:

query {
  me {
    username
    posts {
      id
      type
      caption
      mediaUrl
      thumbnailUrl
      permalink
      publishedAt
    }
  }
}

Send it with curl:

curl -X POST 'https://feedframer.com/graphql?api_key=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"query": "{ me { username posts { id type caption mediaUrl thumbnailUrl permalink publishedAt } } }"}'

RSS feed:

https://feedframer.com/api/v1/rss?api_key=YOUR_API_KEY

Paste this URL into Mailchimp, Klaviyo or any RSS reader.

Getting started

New to Feedframer? The Getting Started guide takes you from sign-up to your first API call.

Documentation sections

Getting started

• Getting Started: create an account, connect Instagram and make your first request
• Connecting Instagram: account requirements, permissions and fixing a connection
• Authentication: where your API key lives and how to regenerate it

API reference

• REST API: the /api/v1/me endpoint and its parameters
• Accounts API: the /api/v1/accounts endpoint
• GraphQL API: the me and post queries
• RSS Feed: the RSS 2.0 feed
• Filtering & Sorting: narrow down and order your posts
• Pagination: page through posts with cursors

Advanced

• Caching & Performance: how responses are cached and when the cache clears
• Error Handling: error codes and what to do about them
• Instagram Graph API Guide: how the underlying Instagram API works

Framework guides

• React
• Vue.js
• Laravel
• Next.js
• WordPress

Code examples

• PHP
• JavaScript
• jQuery
• Python

Email integrations

• Mailchimp: send new posts in a Mailchimp RSS campaign
• Klaviyo: use your feed in Klaviyo emails

Tools and support

When you're logged in, these tools use your own API key:

• API Playground: build a REST request, see the response and copy code in JavaScript, PHP, cURL or Python
• GraphQL Explorer: write and run GraphQL queries
• RSS Feed page: get your RSS feed URL

There's also a public demo you can try without an account.

For help, email [email protected] or use the contact page. Service status is at feedframer.com/status.

Plans

See Pricing to compare plans or upgrade.