{"uid":"cap_ywFmcP50Dt20GEApAYy2y","slug":"instagram-withzero-ai-brightdata-instagram-full-post-history-fetcher-2c7ab264","name":"BrightData Instagram Full Post History Fetcher","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.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_eHnVYIDxj69HeX6boFkwH","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_jKzgbMAldgHRq0_I7mGvF","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.withzero.ai","brandSlug":"instagram-withzero-ai-mpp","brandBaseUrl":"https://instagram.withzero.ai","brandDocsUrl":null,"whatItDoes":"Fetches a complete post history (up to 200 posts) for an Instagram handle using BrightData's async Web Scraper dataset pipeline (trigger → poll → download), billed per post delivered.","exampleAgentPrompt":"Pull the full Instagram post history for @natgeo — up to 200 posts, exclude reels, and only include posts since January 1 2024.","exampleUseCases":null,"resultDescription":"An array of up to 200 post objects, each containing post ID, shortcode, URL, type (photo/video/carousel/reel), isVideo flag, caption, Unix timestamp, takenAt string, like count, comment count, view count, and thumbnail URL. Also includes the handle, result count, snapshot ID, and API version. Billed at $0.0018 per post actually delivered.","failureModes":["Handle not found or account is private — returns empty posts array with resultCount 0 and no charge","BrightData dataset ID not configured — returns configuration error","max_posts out of range (< 1 or > 200) — validation error","Async pipeline timeout — poll may expire before dataset is ready","Rate limiting or BrightData quota exceeded — upstream error propagated","Invalid since_ts value — returns validation error","Both only_reels and exclude_reels set simultaneously — undefined behavior or validation error"],"whenToPreferThis":"Use this endpoint when you need a comprehensive archive of an Instagram account's posts (up to 200), especially for historical research, competitive analysis, or content auditing. Prefer this over the cheaper /latest-posts endpoint when you need depth rather than recency, and over the single-handle endpoint when you need more than the first ~12 posts. The metered pricing (pay only for posts delivered) makes it safe to use even when post count is uncertain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:33.877Z","isFirstParty":true}