{"uid":"cap_kH7ex4bOWLx9I08VsPI6b","slug":"bluesky-post-search-bcff95d7","name":"Bluesky Post Search","description":"Search Bluesky posts by keyword.","url":"https://x402.apidirect.io/v1/bluesky/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 returned). Each page returns up to 50 results. Fetching stops early when there are no more results."},"query":{"type":"string","maxLength":500,"description":"Search keyword (max 500 characters). Bluesky search syntax works: \"exact phrase\", -exclude, from:handle, lang:en, #tag"},"sort_by":{"enum":["most_recent","relevance"],"type":"string","default":"most_recent","description":"Sort order: most_recent or relevance (default: most_recent)"},"end_date":{"type":"string","format":"date","description":"Only posts up to this date (format: YYYY-MM-DD)"},"start_date":{"type":"string","format":"date","description":"Only posts from this date onward (format: YYYY-MM-DD)"},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each result. 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 item"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_igJrx-7jWuplpF7EtRWbf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Bluesky posts by keyword with optional date filtering, sorting, and AI sentiment analysis.","exampleAgentPrompt":"Search Bluesky for posts about 'climate change' from the past week, sorted by most recent, and include AI sentiment analysis on each result.","exampleUseCases":[{"title":"Brand mention monitoring on Bluesky","prompt":"Find the 50 most recent Bluesky posts mentioning 'OpenAI' from the last 7 days and include sentiment analysis so I can see how people feel about them."},{"title":"Hashtag research for a campaign","prompt":"Search Bluesky for posts tagged #veganrecipes sorted by relevance, pull 3 pages of results, and tell me what emotions are most common in those posts."},{"title":"Tracking discussion around a news event","prompt":"Pull Bluesky posts about 'earthquake Turkey' between 2024-01-01 and 2024-01-15, sorted by most recent, so I can see how the conversation evolved."}],"resultDescription":"Returns a merged list of Bluesky posts matching the query (up to 50 per page, up to 20 pages), including post text, author details, timestamps, and optionally a sentiment object per post with emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0-100), dominant emotion, emotional intensity (0-10), and polarity (positive/negative/neutral).","failureModes":["Empty results if no posts match the keyword or date range","Rate limiting or payment failure if x402 payment is not correctly handled","Invalid date format (must be YYYY-MM-DD) returns validation error","Query exceeds 500-character limit returns error","Pages parameter out of range (must be 1-20) returns validation error","Bluesky search syntax errors may return unexpected or empty results"],"whenToPreferThis":"Use this endpoint when you need to search public Bluesky posts by keyword, hashtag, user handle, or phrase — especially when you want date filtering, relevance or recency sorting, multi-page retrieval, or per-post AI emotion/sentiment analysis. Prefer it over general web scraping when you need structured post data from Bluesky specifically. Choose the sibling 'Search Bluesky users' endpoint if you want to find accounts rather than posts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:14.050Z","isFirstParty":false,"canonicalSlug":"bluesky-post-search-bcff95d7"}