Feedframer Documentation

Introduction

Feedframer is an Instagram feed proxy service that simplifies Instagram API integration for developers. Instead of dealing with Instagram's complex OAuth flows, token management, and rate limits, Feedframer handles all of this for you and provides a simple REST and GraphQL API for retrieving your Instagram posts.

What is Feedframer?

Think of Feedframer as a bridge between your application and Instagram. You connect your Instagram Business account once through our simple OAuth flow, and we take care of:

• Managing Instagram OAuth tokens and automatic refreshes
• Fetching and caching your Instagram posts
• Providing a clean, developer-friendly API
• Handling rate limits and API quotas
• Ensuring your data is always fresh and available

When Should You Use Feedframer?

Feedframer is perfect if you need to:

• Display Instagram posts on your website or application
• Build a portfolio or gallery from your Instagram content
• Integrate Instagram content into your marketing site
• Create custom Instagram feeds without the complexity

API Options

Feedframer provides three ways to access your Instagram content:

• REST API - A JSON:API compliant RESTful API for traditional HTTP requests
• GraphQL API - A flexible GraphQL endpoint for precise data fetching
• RSS Feed - RSS 2.0 feed for email automation, feed readers, and content syndication

The REST and GraphQL APIs support:

• Filtering by post type, account, and date range
• Sorting by published date or ID
• Cursor-based pagination
• Tier-based rate limiting

The RSS Feed is perfect for:

• Email marketing automation (Mailchimp, Klaviyo)
• RSS readers and aggregators
• WordPress and content management systems

Quick Example

Here's how simple it is to fetch your Instagram posts with Feedframer:

REST API:

curl 'https://feedframer.com/api/v1/me?api_key=YOUR_API_KEY&page[size]=12'

GraphQL:

query {
  posts(first: 12) {
    data {
      id
      caption
      mediaUrl
      publishedAt
    }
  }
}

RSS Feed:

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

Use this URL in Mailchimp, Klaviyo, or any RSS reader!

Getting Started

Ready to integrate Feedframer into your project? Check out our Getting Started guide.

Documentation Sections

Core Concepts

• Getting Started - Set up your account and make your first API call
• Authentication - Learn how to authenticate your API requests
• Rate Limiting - Understand API rate limits and quotas
• Error Handling - Handle API errors gracefully

API Reference

• REST API - Complete REST API reference
• GraphQL API - Complete GraphQL API reference
• RSS Feed - RSS 2.0 feed documentation
• Filtering & Sorting - Filter and sort your data
• Pagination - Paginate through large datasets

Integration Guides

API Integrations

• PHP Examples - Integrate with vanilla PHP
• Laravel Integration - Use Feedframer in Laravel applications
• JavaScript Examples - Fetch data with JavaScript
• Next.js Integration - Server and client-side rendering with Next.js
• WordPress Integration - Display Instagram feeds in WordPress
• Python Examples - Use Feedframer with Python

RSS Integrations

• Mailchimp RSS Campaign - Email automation with Mailchimp
• Klaviyo RSS Flow - Advanced email flows with Klaviyo

Support

Need help? Here are some resources:

• Documentation - You're here! Browse the guides above
• API Playground - Test API calls directly in your dashboard
• GraphQL Explorer - Interactive GraphQL query builder
• RSS Feed Page - Get your RSS feed URL and integration guides
• GitHub Issues - Report bugs or request features

Pricing

Feedframer offers two tiers:

Free Tier

• Unlimited Instagram accounts
• 6 posts per account
• Daily updates + on-demand refresh
• Unlimited API requests per month
• JSON, GraphQL, and RSS feeds

Premium Tier ($29/month)

• Unlimited Instagram accounts
• 200 posts per account
• 5-minute updates + on-demand refresh
• Unlimited API requests per month
• JSON, GraphQL, and RSS feeds
• Priority support

Upgrade anytime from your billing settings.