Retrieve Instagram post comments on-demand for $0.06 per request via crypto payment.
What it does
This endpoint fetches comments on a specific Instagram post through StableSocial's pay-per-request social media data API. It uses an async two-step flow: you POST with a payment header (USDC on Base, Solana, or Tempo) and receive a JWT token, then poll a separate jobs endpoint (with SIWX wallet auth) until results are ready. Each request costs $0.06.
The endpoint accepts a required `post_id` (Instagram post ID or shortcode) along with optional parameters for pagination (`cursor`, `max_page_size`) and result limits (`max_comments` up to 300, default 50). Sort order can be specified as `date_desc`, `date_asc`, or `id_desc`. This endpoint depends on posts having been previously collected via the `/api/instagram/posts` endpoint for the target profile.
StableSocial is part of a broader 36-endpoint suite covering TikTok, Instagram, Facebook, and Reddit. No API keys or subscriptions are required — payment via the MPP or x402 protocol header serves as authentication. Jobs typically complete in 5–60 seconds, and tokens expire after 30 minutes.
Capabilities
Use cases
- —Sentiment analysis on Instagram post comments
- —Monitoring brand mentions and audience reactions on Instagram
- —Competitive intelligence by analyzing comment engagement on competitor posts
- —Collecting user feedback from Instagram product posts
- —Building datasets of Instagram comment threads for research
Fit
Best for
- —AI agents needing on-demand Instagram comment data without API key management
- —Pay-as-you-go social media research without monthly subscriptions
- —Automated pipelines that need paginated comment retrieval with crypto settlement
Not for
- —Real-time streaming of comments as they arrive (this is async polling-based)
- —Bulk historical data dumps requiring millions of comments (at $0.06/page this adds up)
- —Users without crypto wallets (requires USDC payment on Base, Solana, or Tempo)
Quick start
# Step 1: Trigger comment collection (requires payment header)
curl -X POST https://stablesocial.dev/api/instagram/post-comments \
-H "Content-Type: application/json" \
-d '{"post_id": "CxABC123def", "max_comments": 50}'
# Returns 202 with {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl https://stablesocial.dev/api/jobs?token=eyJ...Example
Request
{
"post_id": "CxABC123def",
"order_by": "date_desc",
"max_comments": 50,
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, documented pricing, and detailed guidance on the async flow. The endpoint returned 405 on HEAD/GET (expected since it's POST-only), and no actual 402 challenge was captured for this specific endpoint, but the OpenAPI spec confirms it's live and priced. No response schema or example response data is provided for the finished job.
Warnings
- —Probe returned 405 because HEAD/GET were used on a POST-only endpoint; endpoint is likely live but 402 challenge was not directly captured
- —No response schema documented — the shape of returned comment data is unspecified in the OpenAPI spec
- —Requires prior call to /api/instagram/posts before comments can be fetched (dependency chain)
Citations
- —Each request costs $0.06 in USDC on Base, Solana, or Tempohttps://stablesocial.dev
- —Async two-step flow: POST to trigger (paid), then poll GET /api/jobs with SIWX wallet authhttps://stablesocial.dev
- —post_id is required; optional params include max_comments (default 50, max 300), order_by, max_page_size, cursorhttps://stablesocial.dev/openapi.json
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev
- —This endpoint depends on posts having been collected first via /api/instagram/postshttps://stablesocial.dev