Fetch Instagram user highlights on demand for $0.06 per request via pay-per-call social data API.
What it does
This endpoint (`POST /api/instagram/highlights`) retrieves highlight reels for a given Instagram user. It is part of StableSocial, a unified pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit across 36 endpoints. Each call costs a flat $0.06 USD, settled via USDC on Base, Solana, or Tempo (MPP/x402). No API keys or subscriptions are required — payment itself serves as authentication.
The endpoint follows an async two-step flow. You POST a JSON body with the target Instagram `handle` (and optional `max_page_size` / `cursor` for pagination). On success, you receive a 202 response containing a signed JWT token. You then poll `GET /api/jobs?token=...` (authenticated via SIWX wallet signature) until the job status transitions to `finished`, at which point the highlight data is returned. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes. This endpoint depends on the user's profile having been collected first via `POST /api/instagram/profile`.
Pagination is cursor-based: each finished response includes a `page_info` object with `has_next_page` and `cursor` fields. Fetching the next page requires a new paid POST. If the trigger POST itself fails (e.g., bad parameters or user not found), you are not charged — payment only settles on 2xx responses.
Capabilities
Use cases
- —Retrieving all highlight reels from a target Instagram account for competitive analysis
- —Building social media monitoring dashboards that track highlight content changes over time
- —Feeding Instagram highlight metadata into an AI agent for brand research
- —Aggregating influencer highlight data across accounts for marketing campaigns
- —Archiving Instagram highlights for compliance or record-keeping purposes
Fit
Best for
- —AI agents needing on-demand Instagram highlight data without managing credentials
- —Developers who want pay-per-call pricing instead of monthly subscriptions
- —Applications that need to scrape Instagram highlights programmatically across many accounts
Not for
- —High-frequency real-time streaming of Instagram data (async polling adds latency)
- —Use cases requiring official Instagram Graph API compliance or verified app review
- —Bulk historical data dumps where per-request pricing would be cost-prohibitive at scale
Quick start
# Step 1: Trigger highlights collection (requires MPP/x402 payment header)
curl -X POST https://stablesocial.dev/api/instagram/highlights \
-H 'Content-Type: application/json' \
-d '{"handle": "natgeo"}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...' \
-H 'SIGN-IN-WITH-X: <siwx_token>'
# → 200 {"status": "finished", "data": {...}}Example
Request
{
"handle": "natgeo",
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, pricing, and detailed guidance documentation are available. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. No response schema or example response data for the highlights payload is documented, and /docs returns 404, so the actual shape of returned highlight data must be inferred.
Warnings
- —Probe returned 405 on HEAD/GET — endpoint only accepts POST, which is expected behavior, not a failure
- —No response schema documented for the highlights data payload; only the job token wrapper is specified
- —The /docs page returns 404; all documentation comes from the OpenAPI x-guidance field
- —This endpoint depends on first calling POST /api/instagram/profile for the same user
- —Data is scraped from Instagram on demand — availability depends on upstream platform access
Citations
- —Each endpoint costs $0.06 per request, settled via USDC on Base, Solana, or Tempohttps://stablesocial.dev
- —The endpoint uses an async two-step flow: POST to trigger (paid), then poll GET /api/jobs with SIWX wallet authhttps://stablesocial.dev/openapi.json
- —Instagram highlights endpoint depends on profile being collected firsthttps://stablesocial.dev/openapi.json
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev/openapi.json
- —Payment only settles on 2xx responses; failed triggers are not chargedhttps://stablesocial.dev/openapi.json
- —36 endpoints across TikTok, Instagram, Facebook, and Reddithttps://stablesocial.dev