{"uid":"cap_ZuDWJ1dvSnfdKMGDnN7xO","slug":"stablesocial-posts-a1c4cca8","name":"StableSocial Instagram Posts","description":"Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.","url":"https://stablesocial.dev/api/instagram/posts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cursor":{"type":"string","description":"Pagination cursor"},"handle":{"type":"string","minLength":1,"description":"Instagram username"},"order_by":{"enum":["date_desc","date_asc","id_desc"],"type":"string","description":"Sort order"},"max_posts":{"type":"integer","default":50,"maximum":300,"minimum":-9007199254740991,"description":"Maximum number of posts to collect"},"max_page_size":{"type":"integer","default":50,"maximum":9007199254740991,"minimum":-9007199254740991,"description":"Results per page"}}},"responseSchema":{"type":"json","example":{"jobId":"clx0000000000000000000000","token":"eyJ...","status":"pending","pollUrl":"https://stablesocial.dev/api/jobs/clx0000000000000000000000"}},"example":{"request":{"handle":"instagram","order_by":"date_desc","max_posts":50,"max_page_size":25},"response":{"jobId":"cmqfwtuak000204l2p51wxwgs","token":"eyJhbGciOiJIUzI1NiJ9.eyJzcCI6Imluc3RhZ3JhbS9wcm9maWxlL2luc3RhZ3JhbS91cGRhdGUiLCJkcCI6Imluc3RhZ3JhbS9wcm9maWxlL2luc3RhZ3JhbS9mZWVkL3Bvc3RzIiwiZHEiOnsibWF4X3BhZ2Vfc2l6ZSI6IjI1Iiwib3JkZXJfYnkiOiJkYXRlX2Rlc2MifSwidyI6IjB4OWNjNDJmM2Q5MjQ1Yjg2N2FjY2NkNjMwYjQzZjkwNmMxNjY1YjE3NiIsImlhdCI6MTc4MTU3MDA4MywiZXhwIjoxNzgxNTcxODgzfQ.RH96AVa-vjR6xhTxjuPrM7JF-IwakhYs2DxD_pT0dlw","status":"pending","pollUrl":"https://stablesocial.dev/api/jobs/cmqfwtuak000204l2p51wxwgs"}},"exampleRequest":{"handle":"instagram","order_by":"date_desc","max_posts":50,"max_page_size":25},"tags":["tiktok","instagram","facebook","reddit","scraping","social","data","x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":4,"rating":{"score":"0.52","successRate":"0.94","reviews":4,"stars":"3.1","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.06/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.06","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OBhzmxBnCNXLK6L0yo0Ck","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_i3DhdnidFT83t2K75a-IG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"StableSocial","brandSlug":"stablesocial","brandBaseUrl":"https://stablesocial.dev","brandDocsUrl":"https://stablesocial.dev","whatItDoes":"Retrieves a paginated list of posts from a specified Instagram user's profile","exampleAgentPrompt":"Pull the 100 most recent Instagram posts from the account '@natgeo', sorted by newest first.","exampleUseCases":null,"resultDescription":"A paginated list of Instagram posts for the specified user, including post content and metadata, along with a cursor for fetching the next page of results.","failureModes":["Invalid or non-existent Instagram handle returns an error","Private account with restricted access returns no posts or an error","Rate limiting or Instagram blocking scraping returns failure","Invalid cursor value causes pagination error","max_posts or max_page_size out of acceptable bounds returns validation error","Payment not completed returns 402 response"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve Instagram post data for a specific user account, especially when you need sorting control, pagination, or bulk collection of up to 300 posts. Prefer this over manual scraping or other social media APIs when you need pay-per-request pricing without a subscription and when you also need coverage across TikTok, Facebook, and Reddit from the same provider.","instructions":null,"reviewSummary":"This Instagram post-retrieval capability uses an async two-call flow: an initial request returns a job token (~2.9s, $0.06), then results are fetched via a separate free polling endpoint. Works well for large public accounts, returning up to 50 structured posts with media URLs, engagement counts, and timestamps. However, small or lightly indexed accounts may silently return empty results, the max_posts parameter is ignored, and some polling attempts encounter 402 authentication errors.","reviewSummaryHighlights":["Fast job initiation (~2.9s) with well-structured post data including media URLs, likes, and timestamps","Free polling endpoint keeps per-request cost low at $0.06 for the initial call"],"reviewSummaryConcerns":["Silently returns empty results for small or low-follower public accounts","max_posts parameter is ignored — always returns 50 posts regardless of requested limit","Two-call async polling flow is undocumented in the capability description; some poll attempts trigger 402 auth errors"],"reviewSummaryGeneratedAt":"2026-07-23T04:15:37.727Z","activationCount":718,"lastUsedAt":"2026-08-09T14:00:10.273Z","lastSuccessfullyRanAt":"2026-08-04T14:02:06.376Z","lastHealthCheckAt":"2026-10-10T23:54:58.618Z","isFirstParty":false,"canonicalSlug":"stablesocial-posts-a1c4cca8"}