MPPtempoquality 0.78

Retrieve Instagram followers for any user — $0.06 per request, paid via USDC on Base, Solana, or Tempo.

Price
$0.06 / call
Protocol
mpp
Verified
no
Endpoint
https://stablesocial.dev/api/instagram/followers

What it does

This endpoint (`POST /api/instagram/followers`) is part of StableSocial, a pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit. It collects the follower list for a given Instagram username. The flow is asynchronous: you POST with a payment header and receive a 202 response containing a JWT token, then poll `GET /api/jobs?token=...` (authenticated via SIWX wallet signature) until the job finishes and returns the follower data. Each request costs $0.06 in USDC, settled on Base, Solana, or Tempo L2. No API keys or subscriptions are required — payment itself serves as authentication.

The endpoint accepts a JSON body with a required `handle` field (Instagram username without @) and optional parameters: `max_followers` (default 500), `max_page_size` (default 100), and `cursor` for pagination. Pagination works by passing the cursor from the previous response's `page_info` into a new paid POST. The endpoint depends on the profile having been collected first via `POST /api/instagram/profile` for complete results.

The service supports both x402 and MPP (Tempo method, charge intent) payment protocols. Job tokens expire after 30 minutes, though jobs typically complete in 5–60 seconds. If the trigger POST fails (e.g., bad parameters or user not found), no payment is charged. The full OpenAPI spec is available at `https://stablesocial.dev/openapi.json`.

Capabilities

instagram-followerssocial-media-datapay-per-requestasync-job-pollingcursor-paginationwallet-auth-siwxx402-paymentmpp-tempo-paymentno-api-key

Use cases

  • —Retrieve the follower list of an Instagram account for audience analysis
  • —Monitor follower growth by periodically collecting follower data
  • —Build social graph datasets by combining follower/following data across accounts
  • —Feed Instagram follower data into an AI agent's research pipeline
  • —Identify influencer audiences for partnership evaluation

Fit

Best for

  • —AI agents that need on-demand Instagram follower data without managing API keys
  • —Researchers collecting social graph data across platforms via a unified interface
  • —Developers who want pay-per-call pricing instead of monthly subscriptions

Not for

  • —High-frequency bulk scraping of millions of followers (pagination cost adds up at $0.06/page)
  • —Applications requiring real-time streaming of follower changes
  • —Use cases needing official Instagram API features like posting or messaging

Quick start

# Step 1: Trigger follower collection (requires payment header)
curl -X POST https://stablesocial.dev/api/instagram/followers \
  -H 'Content-Type: application/json' \
  -d '{"handle": "natgeo", "max_followers": 100}'
# → 202 {"token": "eyJ..."}

# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...'

Example

Request

{
  "handle": "natgeo",
  "max_followers": 100,
  "max_page_size": 50
}

Response

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Endpoint

URLhttps://stablesocial.dev/api/instagram/followers
Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.78/ 1.00

Full OpenAPI schema with clear request parameters, detailed guidance documentation, and confirmed pricing. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. Response schema for the actual follower data is not documented (only the 202 token response is described), and no example response body for finished jobs is provided.

Warnings

  • —Probe returned 405 on HEAD/GET — endpoint only accepts POST, which is expected behavior per the OpenAPI spec
  • —No response schema documented for the actual follower data returned via the /api/jobs polling endpoint
  • —The /docs page returns 404 — documentation is embedded in the OpenAPI x-guidance field only
  • —Dependent endpoint: you must first call POST /api/instagram/profile for the same handle before collecting followers

Citations

Provenance

Indexed frommpp_dev
Enriched2026-04-19 16:37:25Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access

JSONhttps://clawmart.sh/api/listings/BfcUrf