Instagram

​

Prerequisites

• A Facebook account with a Facebook Page that has a linked Instagram Business or Creator account. This is your “viewer” account — you don’t need to own the accounts you’re monitoring.
• The Facebook/Instagram app must have the instagram_basic, pages_show_list, and business_management permissions.

​

How It Works

• Viewer Account — Your authenticated Instagram Business Account. This is the account that makes API calls on your behalf.
• Target Accounts — The public Instagram accounts you want to monitor. Each target is configured as a separate sync config with the account’s username as the source_path.
• One Connection, Many Targets — A single OAuth connection provides the viewer account. You can create unlimited sync configs to monitor different target accounts.

​

Data Flow

Instagram OAuth → Connection (viewer: @your_business_account)
    │
    ├── Sync Config (source_path: "nike")
    │       → Business Discovery API → Media items
    │       → Download to S3 → Bucket Objects
    │       → Collection Pipeline → Qdrant Documents
    │
    ├── Sync Config (source_path: "adidas")
    │       → ...
    │
    └── Sync Config (source_path: "spotify")
            → ...

​

What Gets Synced

​

Setup

from mixpeek import Mixpeek

client = Mixpeek(api_key="your-api-key")

bucket = client.buckets.create(
    bucket_name="instagram-brand-monitor"
)

# Monitor multiple brands
brands = ["nike", "adidas", "apple", "spotify", "netflix"]

for brand in brands:
    sync = client.buckets.syncs.create(
        bucket_id=bucket.bucket_id,
        connection_id="your-connection-id",
        source_path=brand,
        sync_mode="initial_only",
        batch_size=100
    )
    print(f"Created sync for @{brand}: {sync.sync_config_id}")

for sync_config_id in sync_config_ids:
    result = client.buckets.syncs.trigger(
        bucket_id=bucket.bucket_id,
        sync_config_id=sync_config_id
    )
    print(f"Triggered: {result.sync_job_id}")

collection = client.collections.create(
    collection_name="instagram-multimodal",
    source={
        "type": "bucket",
        "bucket_ids": [bucket.bucket_id]
    },
    feature_extractor={
        "feature_extractor_name": "multimodal_extractor",
        "version": "v1",
        "parameters": {
            "run_multimodal_embedding": True
        }
    }
)

​

Resilience

​

Token Lifecycle

1. Short-lived token (1 hour) — Obtained during the OAuth callback.
2. Long-lived token (60 days) — Exchanged automatically during the OAuth flow.
3. Auto-refresh — When a token is within 7 days of expiry, it’s refreshed automatically before each sync execution.

​

Limitations

• Business/Creator accounts only — Business Discovery only works with public Instagram Business or Creator accounts. Personal accounts cannot be discovered.
• Public media only — Only publicly visible posts are accessible. Stories, DMs, and private account content are not available.
• Rate limits — The Graph API allows approximately 200 calls per hour per authenticated account. With a default page size of 25, this supports syncing ~5,000 media items per hour.
• No real-time updates — Media is fetched on-demand when a sync is triggered. Use continuous sync mode for periodic polling.

​

Use Cases