Hunt Townh402
Catalog
SocialPOSTlive

Instagram user posts

List an Instagram user’s posts by handle with engagement metadata.

$0.06
per call
Success
100%
p50 latency
2.71s
p95 latency
2.71s
Calls (30d)
1
Flow① Instagram user posts (this step) →②Social scrape job status(free)— the response's native job handle feeds step ②; agents get the same provider-pinned hint in h402.followUp.

Provider contract

Call path
/routes/stablesocial/social/instagram-posts-async
Method
POST
Selected provider
stablesocialdefault
Provider price
$0.06
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/stablesocial/social/instagram-posts-async' \
  -H 'content-type: application/json' \
  -d '{"handle":"natgeo","max_posts":50,"max_page_size":50}'
CLI
h402 call 'social/instagram-posts-async' --provider 'stablesocial' --method POST --json '{"handle":"natgeo","max_posts":50,"max_page_size":50}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

handlestringrequired

Instagram handle without @.

max_postsintegeroptional1–300default 50

Maximum posts to collect (provider max_posts; max 300, default 50).

e.g.
order_bystringoptional

Sort order.

One of
max_page_sizeintegeroptional≥ 1default 50

Results per page for cursor pagination (provider max_page_size; default 50, no documented maximum).

e.g.
cursorstringoptional

Pagination cursor from a previous response’s meta to fetch the next page.

POST/routes/stablesocial/social/instagram-posts-async
Request body
{
  "handle": "natgeo",
  "max_posts": 50,
  "max_page_size": 50
}

This starts a job — poll Social scrape job status (social/scrape-status) for the final result.

ResponseExample response
{
  "data": {
    "jobId": "cmrw82f2b000c04jp4lucchm0",
    "status": "pending"
  },
  "h402": {
    "routeId": "social/instagram-posts-async",
    "provider": "stablesocial",
    "selectedCandidateId": "social/instagram-posts-async/stablesocial",
    "routing": "manual",
    "followUp": {
      "routeId": "social/scrape-status",
      "path": "/routes/stablesocial/social/scrape-status",
      "method": "GET",
      "params": {
        "jobId": "cmrw82f2b000c04jp4lucchm0"
      },
      "docsUrl": "https://h402-test.hunt.town/catalog/social/scrape-status",
      "instruction": "This response is a job receipt, not the final result. Poll GET /routes/stablesocial/social/scrape-status with the returned id as jobId (free) until the provider reports completion — terminal status labels are provider-native, and a failure status means the job errored. Final-result example: https://h402-test.hunt.town/catalog/social/scrape-status"
    },
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

stablesocial
x402
100
Success
100%
p50
2.71s
Calls
1
100%
$0.06$0.060/call
Last successful call: 25d ago· Aggregated by h402 — not the source provider