{"uid":"cap_DwrUSKUhVjuBAzKpeouQc","slug":"api-direct-instagram-user-stories-40a4236e","name":"API Direct – Instagram User Stories","description":"Get a user's currently active stories by username or profile URL.","url":"https://x402.apidirect.io/v1/instagram/user/stories?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 profile URL, e.g. https://instagram.com/natgeo (max 500 characters). Provide either username or url."},"username":{"type":"string","maxLength":100,"description":"Instagram username, with or without leading @ (max 100 characters). Provide either username or url."}}}},"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_xdTkJLUzlvj1k9uKBid38","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":"Retrieves a user's currently active Instagram Stories by username or profile URL.","exampleAgentPrompt":"Can you pull the currently active stories from the Instagram account @natgeo and show me what they've posted?","exampleUseCases":[{"title":"Brand story monitoring for marketers","prompt":"Check what Instagram stories @nike currently has active — I want to see what campaigns they're running right now."},{"title":"Influencer content audit","prompt":"Pull all the active Instagram stories for the account https://instagram.com/kyliejenner so I can review what she's posting today."},{"title":"Competitor social media tracking","prompt":"What Instagram stories does @redbull have up right now? I'm tracking their social content for a competitive analysis report."}],"resultDescription":"Returns a list of currently active Instagram Stories for the specified user, including story media items, metadata such as timestamps, media type (image or video), and other available story attributes for the given profile.","failureModes":["Username or URL not found — returns empty or error if the account doesn't exist or is private","No active stories — returns empty list if the user has no current stories","Rate limiting — too many requests may result in throttling or error responses","Invalid input — providing neither a username nor a URL results in a validation error","Private account — stories from private profiles may not be accessible"],"whenToPreferThis":"Use this endpoint when you need to fetch the live, currently active Instagram Stories for a specific user by username or profile URL. It is purpose-built for per-user story retrieval and ideal for social monitoring, influencer tracking, competitor analysis, or any workflow that needs near-real-time Instagram story data without managing Instagram API credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:04:25.559Z","isFirstParty":false,"canonicalSlug":"api-direct-instagram-user-stories-40a4236e"}