Social Media Feed API

Social media feed API for reading posts from connected accounts

Read the posts of any connected Instagram, TikTok, YouTube, LinkedIn, Facebook or X account through one feed API, with the same fields on every platform.

Pull a connected account's posts, with captions, thumbnails, permalinks and engagement, from 11 platforms in one shape. Use it to show a feed on a website, power reporting, or give an AI tool context.

Last updated: November 2026

One API keyNo per-account fees15 platformsAPI key authScheduled publishingOfficial APIs838k+ connected accountsDirect engineer support

Quick start
// Read an account's posts, already normalized across platformsconst { posts } = await fetch(  "https://api.bundle.social/api/v1/post-history-import/posts?teamId=team_123&socialAccountType=INSTAGRAM&limit=12",  { headers: { "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY } },).then((r) => r.json());const feed = posts.map((post) => ({  caption: post.description,  image: post.thumbnail,  url: post.permalink,  publishedAt: post.publishedAt,  likes: post.analytics.sort((a, b) => +new Date(b.createdAt) - +new Date(a.createdAt))[0]?.likes ?? 0,}));

Building a social feed natively

  • Instagram's Basic Display API is gone, so website feeds now need the Instagram API with an approved Meta app and a professional account.
  • Each platform pages through posts differently: TikTok returns 20 videos per page, Facebook up to 100, X charges for every read.
  • Every platform names captions, thumbnails and permalinks differently, so one feed component turns into eleven parsers.

What bundle.social handles

  • One endpoint returns posts from 11 platforms with the same fields: caption, title, thumbnail, permalink, publish time and engagement.
  • Imports run as background jobs that handle each platform's pagination and rate limits, so your API call returns right away.
  • The account owner connects through OAuth once and bundle.social keeps the token alive.

Serve your feed from a cache

Calling Instagram or X every time someone loads your page burns rate limits and money. Import the account's posts on a schedule, serve the feed from your own cache, and refresh it when new posts land.

How it works

Connect accounts once, then create and schedule posts with channel-specific fields from one API.

  1. 01

    Connect the account

    The account owner authorizes their account through a hosted connect page.
  2. 02

    Import the posts

    Start an import for the account with the number of posts you need, only the latest ones, or only videos. Poll until it completes.
  3. 03

    Serve your feed

    Read the imported posts in pages of up to 100 and render them, cache them, or pass them to your reporting or AI pipeline.

Build social media workflows without rebuilding every platform

What a social media feed API is for

A feed API returns the posts an account has already published. Developers reach for one to embed an Instagram or LinkedIn feed on a website, to show a customer their recent posts inside a SaaS dashboard, to build reports, or to give an AI writing tool examples of a brand's voice.

Embed widgets solve the website case for one account. A feed API is for products that need posts from many accounts, owned by many customers, in a format their own code controls.

Instagram feed API after Basic Display

Meta shut down the Instagram Basic Display API, which many website feed plugins relied on. Reading an Instagram feed now goes through the Instagram API, which needs an approved Meta app and an Instagram professional account, either Business or Creator.

bundle.social is already an approved Meta app. The account owner connects their professional account through OAuth, and your code reads posts through the same endpoint used for every other platform.

LinkedIn, X and Facebook feeds have their own rules

LinkedIn returns post history only for company pages the user administers, so a LinkedIn feed means a page admin has to connect it. Personal profiles cannot import post history. X charges per post read, so an X feed should be imported on a schedule and cached rather than fetched on every page view. Facebook feeds come from Pages the user manages, not personal profiles.

bundle.social keeps those differences in the import job. The output is the same list of posts regardless of which platform produced it.

Feeds for reporting and AI context

The same posts that fill a website feed are what a reporting tool needs as a baseline and what an AI tool needs as examples. Importing with analytics attaches views, likes and comments to each post at import time, which is enough to rank an account's best content.

For ongoing reporting on posts published outside bundle.social, analytics on imported posts can be refreshed on a schedule with the imported posts analytics add-on.

One feed format across platforms

The fields a feed, a report or an AI tool needs, in the same shape on every platform.

Normalized post fields

Title, description, thumbnail, small thumbnail, permalink, publish time and post type on every platform.

Engagement included

Imports can include an analytics snapshot per post: views, likes, comments, shares and saves where the platform reports them.

Filters that save quota

Import only the latest posts, only videos or images, only grid posts, and decide whether carousels come along.

Background jobs with retry

Imports that hit a platform rate limit pause and resume instead of failing, and failed imports can be retried by ID.

Developer example

Import the latest posts and render a feed

Examples use bundle.social's public API shape: API key authentication, a post date, selected social account types, and platform-specific data.

TypeScript
const headers = { "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY, "Content-Type": "application/json" };// Import the 12 latest grid posts from a connected Instagram accountconst job = await fetch("https://api.bundle.social/api/v1/post-history-import", {  method: "POST",  headers,  body: JSON.stringify({    teamId: "team_123",    socialAccountType: "INSTAGRAM",    count: 12,    onlyLatest: true,    surface: "PROFILE_GRID",    withAnalytics: true,  }),}).then(async (r) => {  // 409 means an import is already running for this account  if (!r.ok) throw new Error(`Import failed to start: ${r.status} ${(await r.json()).message}`);  return r.json();});// Poll the job until it finisheslet status = job.status;while (status !== "COMPLETED" && status !== "FAILED") {  await new Promise((resolve) => setTimeout(resolve, 5000));  const res = await fetch(`https://api.bundle.social/api/v1/post-history-import/${job.id}`, { headers });  if (!res.ok) throw new Error(`Status check failed: ${res.status}`);  ({ status } = await res.json());}// Keep the previous cache if the import failedif (status !== "COMPLETED") throw new Error("Import failed, keeping the cached feed");// Read the newest imported posts for the account and cache them for your feed.// This returns every imported post, so earlier Story or non-grid imports show up too.const { posts } = await fetch(  "https://api.bundle.social/api/v1/post-history-import/posts?teamId=team_123&socialAccountType=INSTAGRAM&limit=12",  { headers },).then((r) => r.json());

Supported content

  • Instagram feed
  • TikTok videos
  • YouTube videos and Shorts
  • LinkedIn page posts
  • Facebook Page posts
  • X posts
  • Threads, Pinterest, Reddit, Bluesky, Mastodon

Honest limitations

  • Feeds cover accounts the owner has connected. bundle.social does not read public profiles of accounts nobody authorized.
  • Imports are capped per account per month: 100 posts on Pro and 500 on Business.
  • How far back an import reaches depends on each platform's API.
  • Instagram requires a professional (Business or Creator) account.
  • X post reads are billed per result at X's API rate.

Developer-first infrastructure

Visible post status

Track scheduled, processing, posted, retrying, and error states per post.

Verbose errors

When native APIs fail, we return human-readable error messages and actionable recovery steps.

Flat pricing

No per-post counting. Predictable pricing for teams managing many users, workspaces, and connected accounts.

Same-day support

Direct access to the engineers building the API. We respond to technical issues the same day, sometimes the same hour.

Technical guides & documentation

Questions developers ask before building

What is a social media feed API?

An API that returns the posts a social account has published, so you can show them on a website, inside your product, or use them in reports and AI tools.

What replaced the Instagram Basic Display API?

The Instagram API. It needs an approved Meta app, which bundle.social provides, and a professional account on the owner's side.

Can I read the feed of any public account?

No. bundle.social reads posts from accounts whose owners connected them. It is not a scraper for public profiles.

How fresh is the feed?

As fresh as your last import. Run an import with onlyLatest on a schedule, or after you publish, to pick up new posts.

Which platforms are supported?

Facebook, Instagram, Threads, TikTok, YouTube, LinkedIn, Pinterest, Reddit, Mastodon, Bluesky and X.

Keep comparing your options