{"uid":"cap_lXt1y1agKQnbg1p8xB9Fe","slug":"api-direct-instagram-post-search-a683b7d1","name":"API Direct – Instagram Post Search","description":"Search for Instagram posts by keyword.","url":"https://x402.apidirect.io/v1/instagram/posts?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":["query"],"properties":{"pages":{"type":"integer","default":1,"maximum":20,"minimum":1,"description":"Number of pages to fetch and merge into one response (1-20, billed per page)"},"query":{"type":"string","maxLength":500,"description":"Search keyword (max 500 characters). Cannot start with @ or #, though either character may appear elsewhere in the query."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each 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). Any post t"}}}},"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_SPuUGe2slXaCOj27jQ4-5","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":"Search for Instagram posts by keyword, optionally including AI-powered sentiment and emotion analysis per post.","exampleAgentPrompt":"Search Instagram for posts about 'sustainable fashion' — grab the first 3 pages of results and include sentiment analysis for each post so I can see the emotional tone.","exampleUseCases":[{"title":"Brand sentiment monitoring on Instagram","prompt":"Search Instagram for posts mentioning 'Nike running shoes' across 5 pages and include sentiment analysis so I can understand how people feel about the brand."},{"title":"Competitor research for a product launch","prompt":"Pull Instagram posts about 'oat milk latte' — get 2 pages worth — so I can see what content is performing and what the conversation looks like."},{"title":"Event buzz tracking","prompt":"Find Instagram posts about 'Coachella 2025' and include the emotion analysis so I can see whether the overall mood is excitement or frustration — fetch 3 pages please."}],"resultDescription":"A merged list of public Instagram posts matching the keyword, across up to 20 pages. Each post includes typical post metadata (content, author, engagement, etc.). When sentiment analysis is enabled, each post also includes an emotions breakdown (joy, trust, fear, surprise, sadness, disgust, anger, anticipation — each scored 0-100), a dominant_emotion field, an emotional_intensity score (0-10), and a polarity label (positive, negative, or neutral).","failureModes":["Query starting with @ or # returns an error — keyword must not begin with those characters","Empty result set if the keyword has no matching public Instagram posts","Pagination limit exceeded if pages parameter is set above 20","Rate limiting or payment failure if USDC balance is insufficient (billed per page fetched)","Truncated results if query exceeds 500 characters"],"whenToPreferThis":"Choose this endpoint when you need to discover public Instagram posts around a specific keyword or topic — especially useful for social listening, brand monitoring, competitive research, or trend analysis. If you also need emotional tone data per post, enable the sentiment flag to get structured emotion scores without a separate enrichment step. Prefer this over user-profile endpoints when you want broad topic coverage rather than a specific account's feed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:26.841Z","isFirstParty":false,"canonicalSlug":"api-direct-instagram-post-search-a683b7d1"}