Fetch Instagram comment replies on-demand for $0.06 per request via MPP/x402.
What it does
This endpoint retrieves replies to a specific Instagram comment. It is part of StableSocial, a pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit (36 endpoints total). Each call costs a flat $0.06 USD, settled via USDC on Base, Solana, or Tempo (MPP method "tempo" with intent "charge"). 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 containing the Instagram `post_id` and `comment_id` (both required), along with optional `max_page_size` (default 50) and `cursor` for pagination. On success, you receive a 202 response with a signed JWT token. You then poll `GET /api/jobs?token=...` (free, but requires SIWX wallet auth proving you are the paying wallet) until the job status is "finished" and data is returned. Tokens expire after 30 minutes; jobs typically complete in 5–60 seconds.
This endpoint depends on prior data collection: you should first trigger the Instagram profile, then posts, then post-comments before requesting comment-replies. If the upstream data hasn't been collected, results may be incomplete. Pagination is cursor-based — continue fetching while `page_info.has_next_page` is true, with each page requiring a new paid POST. Payment only settles on 2xx responses; failed triggers are not charged.
Capabilities
Use cases
- —Retrieving threaded reply conversations under Instagram comments for sentiment analysis
- —Monitoring brand mentions and customer feedback in Instagram comment reply threads
- —Building social listening dashboards that include nested Instagram comment data
- —Collecting Instagram engagement data (replies) for influencer analytics
- —Feeding Instagram comment reply data into LLM-based summarization pipelines
Fit
Best for
- —Agents needing on-demand Instagram comment reply data without managing API keys
- —Pay-as-you-go social media research with no subscription commitment
- —Programmatic collection of nested Instagram comment threads at scale
Not for
- —Real-time streaming of Instagram comments (this is async polling, not push)
- —Bulk historical data dumps requiring millions of requests (cost adds up at $0.06 each)
- —Posting or writing replies to Instagram comments (read-only API)
Quick start
# Step 1: Trigger the job (requires MPP payment header)
curl -X POST https://stablesocial.dev/api/instagram/comment-replies \
-H 'Content-Type: application/json' \
-d '{"post_id": "ABC123", "comment_id": "456789"}'
# → 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
{
"post_id": "ABC123",
"comment_id": "456789",
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, detailed guidance docs embedded in the spec, and consistent pricing. The 402 challenge was not directly captured (endpoint requires POST, probe tried HEAD/GET which returned 405), but the OpenAPI x-payment-info confirms the endpoint is live and priced. No response schema is documented, so the shape of returned reply data is unknown.
Warnings
- —Probe returned 405 on HEAD/GET because this endpoint only accepts POST; this is expected, not a failure.
- —No response schema is documented — the structure of returned Instagram comment reply data is unspecified.
- —The /docs page returns 404; documentation is only available via the OpenAPI spec and embedded x-guidance.
- —This endpoint depends on prior collection of Instagram profile, posts, and post-comments data.
Citations
- —Each call costs $0.06 USD, fixed pricehttps://stablesocial.dev
- —Supports MPP method tempo with intent charge, and x402 protocolhttps://stablesocial.dev/openapi.json
- —Async two-step flow: POST to trigger (202 with JWT), then poll GET /api/jobs with SIWX authhttps://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev
- —Required parameters are post_id and comment_id; optional max_page_size and cursorhttps://stablesocial.dev/openapi.json
- —Payment only settles on 2xx responses; failed triggers are not chargedhttps://stablesocial.dev
- —comment-replies depends on prior post-comments collectionhttps://stablesocial.dev