{"uid":"cap_6vAX62Zy0DP0IDrF27RBm","slug":"bluesky-posts-search-039dcdc1","name":"Bluesky Posts & Search","description":"Bluesky Posts & Search: find public Bluesky posts by keyword, phrase, hashtag or from:handle through the AT Protocol AppView, newest first. Per post the text, author handle and display name, likes, replies, reposts, language, media links, time and URL, in one schema shared by every platform; next_cursor gives the next page. Social listening on Bluesky for brands, products and topics. Bad input is free; not found or no match is not charged.","url":"https://social.duoleads.com/v1/bluesky/search?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"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":200,"description":"Search text (1-200 characters; Bluesky search syntax such as from:, #tag and quotes works)."},"limit":{"type":"string","pattern":"^[0-9]{1,4}$","description":"Posts per page, 1-25. Default 25."},"cursor":{"type":"string","maxLength":512,"description":"next_cursor of the previous page."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-10-15T12:00:00.000Z","items":[{"id":"at://did:plc:synth000000000000000000000001/app.bsky.feed.post/3lsynth000001","url":"https://bsky.app/profile/synth-alpha.bsky.social/post/3lsynth000001","lang":"en","text":"The synthwidget launch went really well, great work team!","type":"post","author":{"handle":"synth-alpha.bsky.social","verified":true,"followers":null,"display_name":"Synthetic Alpha"},"metrics":{"likes":42,"views":null,"replies":3,"reposts":5},"platform":"bluesky","parent_id":null,"created_at":"2026-10-14T10:00:00.000Z","media_urls":["https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:synth000000000000000000000001/bafkreiimg@jpeg"]},{"id":"at://did:plc:synth000000000000000000000002/app.bsky.feed.post/3lsynth000002","url":"https://bsky.app/profile/synth-beta.example.com/post/3lsynth000002","lang":"en","text":"synthwidget is not working for me today","type":"post","author":{"handle":"synth-beta.example.com","verified":false,"followers":null,"display_name":"Synthetic Beta"},"metrics":{"likes":1,"views":null,"replies":0,"reposts":0},"platform":"bluesky","parent_id":null,"created_at":"2026-10-14T11:30:00.000Z","media_urls":[]}],"query":{"q":"synthetic widgets","limit":10,"cursor":null},"source":"public data via the Bluesky AppView API; not affiliated with Bluesky","complete":true,"platform":"bluesky","disclaimer":"Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.","request_id":"01KEXAMPLE0000000000000000","next_cursor":"25"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_J0x5yjzFggnm9BE0TkyrF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search public Bluesky posts by keyword, hashtag, or handle using AT Protocol AppView, returning paginated results with engagement metrics and metadata.","exampleAgentPrompt":"Search Bluesky for recent posts mentioning 'open source AI' and show me the top 10, including who posted them, how many likes they got, and links to the posts.","exampleUseCases":[{"title":"Brand mention monitoring on Bluesky","prompt":"Search Bluesky for any posts mentioning 'Acme Corp' and show me the newest ones — I want to see the post text, author handle, and engagement numbers like likes and reposts."},{"title":"Hashtag campaign tracking","prompt":"Find the latest 25 Bluesky posts using the hashtag #AIWeek and give me the full list with authors, timestamps, and how many replies each one got."},{"title":"Competitor product sentiment check","prompt":"Search Bluesky for posts talking about 'RivalApp' and show me the most recent ones so I can get a sense of what people are saying about it — include likes, reposts, and links to each post."}],"resultDescription":"A JSON object containing a paginated list of matching Bluesky posts, each with: AT Protocol post ID, direct post URL, language code, post text, author handle and display name, engagement metrics (likes, replies, reposts), platform identifier, media URLs if present, and creation timestamp. Also includes query echo, a next_cursor for pagination, source disclaimer, and a request ID.","failureModes":["Invalid or empty query string returns an error (not charged)","No matching posts returns an empty items array (not charged)","Invalid cursor string may return an error or reset to first page","Rate limits from the upstream Bluesky AppView may cause temporary failures","Queries exceeding 200 characters are rejected by schema validation","Non-existent handles in from: syntax return empty results"],"whenToPreferThis":"Choose this endpoint when you specifically need to search public Bluesky posts by keyword, hashtag, or handle. It is ideal for social listening, brand monitoring, trend tracking, or content discovery on Bluesky. Prefer it over the Social Search Across Platforms sibling when you want Bluesky-only results with full post metadata. Prefer it over Bluesky Account Posts Feed when you want topic-based search rather than a specific account's timeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:59:45.262Z","isFirstParty":false,"canonicalSlug":"bluesky-posts-search-039dcdc1"}