Add an Instagram feed to your website

Quick start

1. Create a free account. Sign up with your email address — no password, we send you a login link.
2. Pick your integration. WordPress plugin, PHP widget or the JSON API. Your API token is in the dashboard.
3. Embed the feed. The profile you ask for is fetched on the first request and then kept up to date automatically.

The Instagram account must be a Business or Creator account (free to switch in the Instagram app). Private and personal accounts can't be read.

WordPress

Install quqii – Social Media Feed Grid from the plugin directory, connect it to your account in the plugin's settings, then add a shortcode or the Social Media Feed block in the editor.

[quqii-feed instagram="quqii.official"]

Examples

# Swipeable slider with autoplay
[quqii-feed instagram="quqii.official" layout="slider" autoplay="1"]

# 4 columns, no gaps, square corners
[quqii-feed instagram="quqii.official" columns="4" no-gap="1" no-radius="1"]

# Only the images, 8 posts, captions on tap
[quqii-feed instagram="quqii.official" profile="0" limit="8" caption="1" captionpos="overlay"]

# Just the follower count, inline in a sentence
[quqii-feed instagram="quqii.official" display="followers"]

Shortcode attributes

Only instagram is required. For every other attribute you can set a default in the plugin's settings; the attribute overrides it for one feed.

Works in every page builder that supports shortcodes (Elementor, Divi, WPBakery and others). In a theme template use <?php echo do_shortcode('[quqii-feed instagram="quqii.official"]'); ?>.

PHP widget

For any PHP website. One file, three steps: include the widget, fetch the profile from the API, render it. Download quqii-widget.php from your dashboard — your token is already filled into the example there.

<?php
require 'quqii-widget.php';

$token    = 'YOUR_TOKEN';
$username = 'quqii.official';
$posts    = 12;   // how many posts you show

$response = @file_get_contents(
    'https://feed.quqii.net/api.php?u=' . urlencode($username) . '&limit=' . $posts . '&token=' . $token
);
$profile = $response ? json_decode($response, true) : null;
?>

<div>
    <?php quqii_render($profile, ['columns' => 4]); ?>
</div>

Options for quqii_render()

Named like the shortcode attributes. All are optional.

Captions, the slider layout and playing videos in an overlay are available in the WordPress plugin only.

JSON API

Use the API from any language to build your own layout. Send your token as a header; every request counts as one API call.

curl -H "Authorization: Bearer YOUR_TOKEN" \
     "https://feed.quqii.net/api.php?u=quqii.official&limit=12"

Request parameters

Response

{
  "username": "quqii.official",
  "fullName": "quqii",
  "followersCount": 3800,
  "profilePicUrlHD": "https://...",
  "latestPosts": [
    {
      "id": "17900000000000000",
      "type": "Image",
      "shortCode": "AbC_123",
      "url": "https://www.instagram.com/p/AbC_123/",
      "displayUrl": "https://...",
      "caption": "...",
      "timestamp": "2026-10-12T10:43:00+0000",
      "likesCount": 42,
      "commentsCount": 3
    }
  ]
}

Image and video URLs are Instagram's own and stop working after a few days. Always use a fresh response and don't store the URLs. The service refreshes each profile automatically, at the latest every three days.

Answers & errors

Limits

Each plan has a number of API calls per billing period and a maximum number of posts per feed — see Pricing. A billing period starts on the day you subscribe to a paid plan; with a free account it is the calendar month. Your dashboard shows the usage and when it starts over.

When the call limit is reached, feeds keep working with the posts that were already visible, and new posts are no longer shown until the next period starts (or you upgrade). You get an email at 80 % and 90 % of your limit.