Fetch Instagram user profiles on demand for $0.06 per request via pay-per-call social data API.
What it does
This endpoint retrieves Instagram user profile information through StableSocial's unified social media data API. You POST a JSON body containing an Instagram username (without @) and receive a 202 response with a JWT job token. You then poll a separate jobs endpoint (GET /api/jobs?token=...) with SIWX wallet authentication until the profile data is ready. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes.
StableSocial covers four platforms (TikTok, Instagram, Facebook, Reddit) across 36 endpoints, all at a flat $0.06 USD per request. Payment settles in USDC on Base, Solana, or Tempo (pathUSD). No API keys or signups are required — the payment header itself serves as authentication for trigger calls. The Instagram profile endpoint has no dependencies on other endpoints, making it a standalone entry point. Related Instagram endpoints (posts, followers, following, stories, highlights, comments, search) each depend on having first fetched the profile.
The async two-step flow means callers must handle polling. If the upstream data collection fails, the job returns a "failed" status and the caller is not charged. Pagination is supported via cursor-based parameters for endpoints that return lists. The OpenAPI spec is published at /openapi.json and covers all 36 endpoints with full request schemas.
Capabilities
Use cases
- —Retrieving Instagram user profile metadata (bio, follower count, post count) for influencer research
- —Feeding Instagram profile data into an AI agent's context for social media analysis
- —Building competitive intelligence dashboards that aggregate profiles across platforms
- —Enriching CRM records with public Instagram profile information
- —Monitoring brand accounts for profile changes over time
Fit
Best for
- —AI agents needing on-demand Instagram profile data without managing credentials
- —Pay-as-you-go social data collection without monthly subscriptions
- —Developers who want a single unified API across TikTok, Instagram, Facebook, and Reddit
Not for
- —High-volume bulk scraping where per-request costs add up quickly
- —Use cases requiring real-time streaming of Instagram data (this is async polling)
- —Accessing private or non-public Instagram account data
Quick start
# Step 1: Trigger profile fetch (requires payment header)
curl -X POST https://stablesocial.dev/api/instagram/profile \
-H 'Content-Type: application/json' \
-d '{"handle": "natgeo"}'
# Returns 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>'Example
Request
{
"handle": "natgeo"
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters and documented async flow. The 402 challenge was not captured because the endpoint only accepts POST (HEAD/GET returned 405), but the OpenAPI spec confirms it is live and priced. No response schema is documented for the actual profile data, and /docs returns 404, so the exact shape of returned profile data is unknown.
Warnings
- —Probe returned 405 on HEAD/GET because this endpoint only accepts POST — not an indication of downtime
- —No response schema documented for the profile data payload; the shape of returned data is unknown
- —The /docs page returns 404; all documentation comes from the OpenAPI spec and landing page
- —Data is scraped from Instagram on demand — availability depends on upstream platform access
Citations
- —All endpoints cost $0.06 per request in USDC on Base, Solana, or Tempohttps://stablesocial.dev
- —The Instagram profile endpoint accepts POST with a JSON body containing 'handle' (Instagram username without @)https://stablesocial.dev/openapi.json
- —Async two-step flow: POST returns 202 with JWT token, then poll GET /api/jobs with SIWX wallet authhttps://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev
- —Payment settles only on 2xx responses; failed triggers are not chargedhttps://stablesocial.dev
- —36 endpoints across TikTok, Instagram, Facebook, and Reddithttps://stablesocial.dev