{"uid":"cap_PxzX82QKHQf0AdYM3HPxC","slug":"instagram-data-withzero-ai-instagram-full-post-history-fetcher-9f57df3b","name":"Instagram Full Post History Fetcher (BrightData Async)","description":"Fetch a handle's FULL post history via the BrightData Instagram Posts dataset (async Web Scraper: trigger → poll → download). Metered: buyer authorizes up to $0.36 (200 posts × $0.0018) and is billed $0.0018 per post actually delivered (0 posts → free). Body: handle (required), max_posts (1–200, default 100), since_ts, only_reels, exclude_reels. Requires BRIGHTDATA_IG_POSTS_DATASET_ID to be configured.","url":"https://instagram-data.withzero.ai/full-profile","method":"POST","headers":{},"bodySchema":{"type":"object","required":["handle"],"properties":{"handle":{"type":"string","description":"Instagram handle (with or without @) to fetch full history for."},"since_ts":{"type":"integer","description":"Unix seconds watermark — keep only posts with timestamp > since_ts."},"max_posts":{"type":"integer","maximum":200,"minimum":1,"description":"Max posts to fetch (default 100, cap 200)."},"only_reels":{"type":"boolean","description":"Keep only reels."},"exclude_reels":{"type":"boolean","description":"Drop reels."}},"additionalProperties":false},"responseSchema":{"type":"object","required":["apiVersion","source","handle","resultCount","posts"],"properties":{"posts":{"type":"array","items":{"type":"object","required":["id","shortcode","url","type","isVideo","caption","timestamp","takenAt","likes","comments","views","thumbnailUrl"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"type":{"enum":["photo","video","carousel","reel"],"type":"string"},"likes":{"type":"number","nullable":true},"views":{"type":"number","nullable":true},"caption":{"type":"string"},"isVideo":{"type":"boolean"},"takenAt":{"type":"string"},"comments":{"type":"number","nullable":true},"shortcode":{"type":"string"},"timestamp":{"type":"number"},"thumbnailUrl":{"type":"string","nullable":true}},"additionalProperties":false}},"handle":{"type":"string"},"source":{"enum":["async"],"type":"string"},"apiVersion":{"enum":[1],"type":"number"},"snapshotId":{"type":"string"},"resultCount":{"type":"number"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.36","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":{"amountUsd":"0.36","asset":"USDC"},"pricing":{"kind":"session","summary":"$0.36/post","primary":{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.36","per":"post","confidence":"exact","depositUsd":"0.36"},"accepted":[{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.36","per":"post","confidence":"exact","depositUsd":"0.36"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.36","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nujirmq-VU8DV_uNy1ubj","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"session","costAmount":"0.36","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"post","depositMicros":360000,"planRef":"instagram-data-post-full-profile:1"},{"uid":"pm_t3BcWfyoF6JdIR-rt6EYd","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.36","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"instagram-data.withzero.ai","brandSlug":"instagram-data-withzero-ai-mpp","brandBaseUrl":"https://instagram-data.withzero.ai","brandDocsUrl":null,"whatItDoes":"Fetches the complete post history for an Instagram handle using BrightData's async dataset pipeline, with metered per-post billing up to 1000 posts.","exampleAgentPrompt":"Pull the full post history for the Instagram handle @natgeo — up to 500 posts, photos and carousels only (no reels), going back only to posts after January 1st 2024.","exampleUseCases":null,"resultDescription":"Returns an array of up to 1000 post objects for the requested Instagram handle, each containing post ID, shortcode, URL, media type (photo/video/carousel/reel), caption, like count, comment count, view count, thumbnail URL, and timestamps. Also includes total result count, handle, source mode, and optional snapshot ID for the async job.","failureModes":["Handle not found or account is private — returns empty posts array with resultCount 0, billed $0","BRIGHTDATA_IG_POSTS_DATASET_ID not configured — returns server configuration error","max_posts exceeds 1000 or is below 1 — returns 400 validation error","Invalid since_ts value — returns 400 validation error","BrightData upstream timeout or dataset unavailability — async poll may fail or stall","Conflicting only_reels and exclude_reels flags both set to true — undefined behavior or error"],"whenToPreferThis":"Choose this endpoint when you need the full or deep post history of a single Instagram handle (up to 1000 posts) and can tolerate an async trigger-poll-download workflow. It is better than the single-handle sync endpoint when you need more than ~12 posts, and better than the batch endpoint when you only need one account but want deep history. The per-post metered billing ($0.0018/post) means you only pay for what is actually delivered.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:30.242Z","isFirstParty":true}