{"uid":"cap_HJ0FoCn8iuJEzNwZIQ1sV","slug":"bluesky-engagement-metrics-api-x402-ad19772a","name":"Bluesky Engagement Metrics API (x402)","description":"Auto-generated REST API matching active Model Context Protocol (MCP) tools.","url":"https://api.naco.li/v1/getEngagementMetrics","method":"POST","headers":{},"bodySchema":{"type":"object","required":["author"],"properties":{"limit":{"type":"integer"},"author":{"type":"string"},"endTime":{"type":"string"},"platform":{"type":"string"},"startTime":{"type":"string"}}},"responseSchema":{"type":"object","required":["author","metrics","twitterPostCount"],"properties":{"author":{"type":"string"},"metrics":{"type":["null","array"],"items":{"type":"object","required":["postId","timestamp","likes","reposts","replies","quotes","engagementRate"],"properties":{"likes":{"type":"integer"},"postId":{"type":"string"},"quotes":{"type":"integer"},"replies":{"type":"integer"},"reposts":{"type":"integer"},"timestamp":{"type":"string"},"engagementRate":{"type":"number"}},"additionalProperties":false}},"twitterPostCount":{"type":"integer"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pb0NPKNundg3xdskF4NnJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves per-post engagement metrics (likes, reposts, replies, quotes, engagement rate) for a given Bluesky author over a specified time range.","exampleAgentPrompt":"Pull the engagement metrics for the Bluesky author @nntaleb.bsky.social — I want likes, reposts, replies, quotes, and engagement rate for their last 20 posts from January 1 to March 31 2025.","exampleUseCases":[{"title":"Influencer performance audit","prompt":"Get me the full engagement breakdown — likes, reposts, replies, quotes, and engagement rate — for @casey.bsky.social on Bluesky for the past 30 days, looking at up to 50 posts."},{"title":"Competitor social benchmarking","prompt":"I need to compare how @techcrunch.bsky.social is performing on Bluesky; pull their post-level engagement metrics for February 2025, up to 25 posts."},{"title":"Campaign post-mortem analysis","prompt":"Fetch engagement metrics for @mybrand.bsky.social on Bluesky between March 10 and March 20 2025 so I can see how our product launch posts performed — all posts, no limit."}],"resultDescription":"Returns a JSON object containing the author handle and an array of per-post metric objects. Each object includes the postId, timestamp, likes, reposts, replies, quotes, and a computed engagementRate (float). The metrics array may be null if no posts are found for the given parameters.","failureModes":["Author handle not found or does not exist on Bluesky — metrics array returns null","Invalid or unparseable startTime/endTime format — likely a 400 or malformed response","Limit set to 0 or negative — may return empty results","Payment not completed (x402) — request blocked before processing","Platform field set to unsupported value — undefined behavior or empty result"],"whenToPreferThis":"Choose this endpoint when you need per-post Bluesky engagement metrics (likes, reposts, replies, quotes, engagement rate) for a specific author, especially when operating as an autonomous agent that can handle x402 micropayment flows. It is purpose-built for the Bluesky / AT Protocol ecosystem and returns structured per-post data, making it ideal for analytics, benchmarking, or campaign monitoring workflows rather than generic social listening tools.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:42:33.970Z","isFirstParty":false}