# MapleAI X Media Search — Twitter/X Visual Content Analysis

> MapleAI X Media Search — Twitter/X Visual Content Analysis is a paid API for AI agents from base.mapleai.shop, paid per call via x402, $0.037/call, status unknown (last checked 2026-10-10).

Searches Twitter/X posts by query and analyzes their embedded images or videos using AI vision, returning descriptions, engagement stats, and relevance scores.

## Facts

- Endpoint: POST https://base.mapleai.shop/v1/x/media?utm_source=zero.xyz
- Price: $0.037/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mapleai-x-media-search-twitter-x-visual-content-analysis-59f23b3f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_20nG-y6LztTqC4ZGhktr3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mapleai-x-media-search-twitter-x-visual-content-analysis-59f23b3f -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

14 chat models (GPT + Claude), 7 image models, and Jev structured decisions. Pay per request in USDC on Base with x402.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapleai-x-media-search-twitter-x-visual-content-analysis-59f23b3f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base.mapleai.shop](https://www.zero.xyz/host/base.mapleai.shop/llms.txt)