{"uid":"cap_20nG-y6LztTqC4ZGhktr3","slug":"mapleai-x-media-search-twitter-x-visual-content-analysis-59f23b3f","name":"MapleAI X Media Search — Twitter/X Visual Content Analysis","description":"14 chat models (GPT + Claude), 7 image models, and Jev structured decisions. Pay per request in USDC on Base with x402.","url":"https://base.mapleai.shop/v1/x/media?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["top","latest"],"type":"string","default":"top","description":"top = highest-engagement posts, latest = freshest"},"query":{"type":"string","maxLength":500},"hours_back":{"type":"integer","default":24,"maximum":168,"minimum":1},"media_type":{"enum":["image","video","both"],"type":"string","default":"image","description":"Which media understanding to enable (image is cheapest)"},"max_results":{"type":"integer","default":8,"maximum":15,"minimum":1,"description":"Posts analyzed; drives the price"}}},"responseSchema":{"type":"json","example":{"object":"x.media","results":[{"url":"https://x.com/user/status/123","likes":920,"relevance":"Shows adoption growth asked about","media_type":"image","description":"Line chart of daily transactions, rising from 2M to 6M"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.037","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.037/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.037","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.037","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HB0k__j-mAXbMFAaApLbD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.037","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Twitter/X posts by query and analyzes their embedded images or videos using AI vision, returning descriptions, engagement stats, and relevance scores.","exampleAgentPrompt":"Search X for the top posts about 'Base blockchain adoption' from the last 48 hours, analyze up to 10 posts, and describe what images they contain — show me the top-engagement ones with image media only.","exampleUseCases":[{"title":"Track visual evidence of product launch buzz","prompt":"Search X for the latest posts about the 'GPT-5 release' from the past 24 hours, look at up to 8 image posts, and tell me what the visuals are showing — I want to see what people are actually sharing."},{"title":"Monitor competitor brand sentiment via images","prompt":"Find the top-engagement tweets mentioning 'Coinbase wallet' over the last 72 hours that have images, analyze up to 12 of them, and summarize what those images are depicting."},{"title":"Gather chart evidence for a market research report","prompt":"Pull the most liked posts on X about 'DeFi TVL growth' from the last week, analyze up to 15 posts with images only, and describe each chart or graph you find — I'm building a report."}],"resultDescription":"A JSON array of analyzed posts, each containing the tweet URL, like count, detected media type, an AI-generated description of the image or video content, and a relevance explanation tying the visual back to the search query.","failureModes":["Query returns no matching posts with media — empty results array","hours_back or max_results out of allowed range — validation error","Payment not processed via x402 — 402 Payment Required response","Query too long (>500 chars) — schema validation error","X/Twitter API rate limits or access issues causing upstream failure"],"whenToPreferThis":"Choose this endpoint when you need AI-interpreted visual content from Twitter/X posts — not just text — for a given search topic. It's uniquely suited for trend monitoring, brand tracking, or evidence gathering where the images or videos in tweets carry the signal. Prefer it over generic web search when you specifically need social media visual content with engagement context (likes) and AI-generated image descriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:38:44.995Z","isFirstParty":false,"canonicalSlug":"mapleai-x-media-search-twitter-x-visual-content-analysis-59f23b3f"}