{"uid":"cap_XMlG5zRse_7xz3dGWJ7K6","slug":"oblique-markets-x-com-tweet-search-4e857696","name":"Oblique Markets X.com Tweet Search","description":"Use when an agent needs tweets search. Returns Search publicly indexed social posts by words, phrases, hashtags, account and date filters, returning bounded tweet-like results and source links. $0.005.","url":"https://api.oblique.markets/api/v1/paid/tweets-search","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","properties":{"to":{"type":"string"},"from":{"type":"string"},"since":{"type":"string"},"until":{"type":"string"},"words":{"type":"string"},"phrase":{"type":"string"},"hashtags":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","properties":{"count":{"type":"integer"},"query":{"type":"string"},"source":{"type":"string"},"tweets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"text":{"type":"string"},"author":{"type":"null"},"source":{"type":"string"},"created_at":{"type":"string"}}}},"next_cursor":{"type":"null"}}}}},"responseSchema":{"type":"json","example":{"count":1,"query":"words=x402","source":"google-news-rss-x.com-index","tweets":[{"id":"example-guid","url":"https://news.google.com/rss/articles/example","text":"AI agents can pay APIs per request with x402.","author":null,"source":"x.com (Google News index)","created_at":"Mon, 17 Aug 2026 19:59:41 GMT"}],"next_cursor":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ovl6iKOQIptUQS1XJlLH2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search publicly indexed X.com (Twitter) posts using filter parameters like author, keywords, phrases, hashtags, and date range, returning bounded tweet-like results with source links","exampleAgentPrompt":"Search X.com for tweets from @elonmusk that mention 'Grok' posted between January 1 and March 31 2025 — I want to see what he's been saying about it publicly.","exampleUseCases":[{"title":"Brand mention monitoring on X","prompt":"Search X.com for any posts containing the phrase 'OpenAI GPT-5' since April 1 2025 — I want to see what people are publicly saying about it this month."},{"title":"Competitor hashtag research","prompt":"Find tweets using the hashtag #Solana posted between March 1 and March 31 2025 so I can understand the community sentiment and key talking points."},{"title":"Influencer content lookup","prompt":"Show me recent tweets from @VitalikButerin that include the word 'scaling' — I want to review his latest public statements on the topic."}],"resultDescription":"A bounded list of publicly indexed tweet-like objects matching the query, each including the post content and a source link back to the original X.com post. Results are constrained by the query parameters provided (author, keywords, phrase, hashtags, date range).","failureModes":["No results returned if the query parameters match no indexed posts","Payment failure or 402 response if USDC micropayment is not completed","Invalid date format for 'since' or 'until' causing query rejection","Empty or missing 'words'/'phrase' with no other filters returning overly broad or rejected queries","Rate limiting if the endpoint is called excessively within a short window"],"whenToPreferThis":"Use this endpoint when you need to search publicly indexed X.com posts with structured filters (author, keyword, phrase, hashtag, date range) and can pay a $0.005 USDC micropayment per call. Prefer this over scraping or unofficial Twitter APIs when you need a clean, agent-compatible x402-payment-gated query interface with bounded, citable results. Ideal for social listening, sentiment research, or finding specific public statements from known accounts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:45:38.842Z","isFirstParty":false}