{"uid":"cap_kc5W4lwa6zM7JYMgtFbx8","slug":"instagram-post-lookup-by-url-shortcode-or-media-id-30d6f2b8","name":"Instagram Post Lookup by URL, Shortcode, or Media ID","description":"Look up a single Instagram post, reel, or IGTV video by URL, shortcode, or numeric media ID.","url":"https://x402.apidirect.io/v1/instagram/post?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"url":{"type":"string","maxLength":500,"description":"Instagram post, reel, IGTV, or story URL, e.g. https://www.instagram.com/p/CxYQJO8xuC6/ (max 500 characters). Must be an instagram.com URL containing /p/, /reel, /tv/, or /stories/. Provide either url or code."},"code":{"type":"string","maxLength":50,"description":"The post's shortcode, e.g. CxYQJO8xuC6, or numeric media ID (max 50 characters, letters/digits/-/_ only). Provide either url or code."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to the post. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). If the post"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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":null,"pricing":{"kind":"static","summary":"$0.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uZblqSXqknD5mgepQ3ufI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches metadata and content for a single Instagram post, reel, or IGTV video given its URL, shortcode, or numeric media ID, with optional AI sentiment analysis.","exampleAgentPrompt":"Can you pull up the details for this Instagram post — https://www.instagram.com/p/CxYQJO8xuC6/ — and also run sentiment analysis on it so I can see the dominant emotion and emotional intensity?","exampleUseCases":[{"title":"Track competitor brand post details","prompt":"Grab all the details from this Instagram reel — https://www.instagram.com/reel/CxYQJO8xuC6/ — including likes, caption, and any engagement metrics you can find."},{"title":"Sentiment check on viral post","prompt":"Look up this Instagram post by its shortcode CxYQJO8xuC6 and run the AI sentiment analysis on it — I want to know the dominant emotion, polarity, and how intense it is."},{"title":"Archive IGTV video metadata","prompt":"Fetch the metadata for this IGTV video at https://www.instagram.com/tv/CxYQJO8xuC6/ so I can save the caption, post date, and media details to my database."}],"resultDescription":"Returns structured data about the Instagram post including caption, media type (post/reel/IGTV), engagement metrics (likes, comments count), author info, timestamp, and media URLs. If sentiment is requested, also returns an emotions object with scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0-100), a dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative, or neutral).","failureModes":["Invalid or non-Instagram URL returns an error indicating the URL is not supported","Post not found or private/deleted returns a 404-equivalent error","Missing both url and code parameters returns a validation error requiring one of them","Non-Instagram URL (e.g. Twitter or TikTok link) rejected with URL format validation error","Rate limits or Instagram-side blocking may cause temporary unavailability"],"whenToPreferThis":"Use this endpoint when you need structured data from a specific, known Instagram post, reel, or IGTV video identified by URL, shortcode, or media ID — especially when you also want AI-powered emotion and sentiment analysis. Prefer this over search-based endpoints when you already have the post's identifier and need its full content details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:17.951Z","isFirstParty":false,"canonicalSlug":"instagram-post-lookup-by-url-shortcode-or-media-id-30d6f2b8"}