# Meterly.AI X.com (Twitter) Data Endpoint

> Meterly.AI X.com (Twitter) Data Endpoint is a paid API for AI agents from meterly-ai.vercel.app, paid per call via x402, $0.12/call, status unknown (last checked 2026-09-14).

Fetches data from X.com (Twitter) including user profiles, tweets, or search results via a pay-per-call API using USDC on Base Mainnet

## Facts

- Endpoint: POST https://meterly-ai.vercel.app/api/v1/x-com2
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meterly-ai-x-com-twitter-data-endpoint-8b960f2c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HZP_9mzeHJPTyQ16zUea6

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 meterly-ai-x-com-twitter-data-endpoint-8b960f2c -d '<json body>'
```

Example prompt: Search X.com for the latest tweets about 'AI agents' and return up to 20 results — I want to see what people are saying about autonomous AI on Twitter right now.

## When to prefer this

Use this endpoint when you need to programmatically retrieve Twitter/X.com data (tweets, profiles, search results) without managing your own Twitter API credentials, and you can pay per call in USDC via the x402 protocol on Base Mainnet. It is best for AI agents needing on-demand social media intelligence without subscription overhead.

## Known failure modes

- Missing required 'query' field returns a validation error
- Invalid or suspended Twitter username returns empty or error response
- Payment failure on Base Mainnet blocks the call entirely
- Rate limits on underlying Twitter API may cause intermittent failures
- Ambiguous or overly broad queries may return irrelevant results
- Private accounts may return no data

## How this service works

Pay-per-call API infrastructure for AI agents, bots, and developers. Access 95+ premium APIs with USDC payments on Base Mainnet via x402 protocol.

## Output

Returns a JSON object containing Twitter/X.com data matching the query — likely including tweets, user profile fields, post metadata, or search result listings, depending on what was queried.

## Request schema (JSON Schema)

```json
{
 "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": {
      "url": {
       "type": "string",
       "description": "URL to process"
      },
      "limit": {
       "type": "number",
       "description": "Maximum results to return"
      },
      "query": {
       "type": "string",
       "description": "Search query or input data"
      },
      "username": {
       "type": "string",
       "description": "Username or profile identifier"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meterly-ai-x-com-twitter-data-endpoint-8b960f2c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meterly-ai.vercel.app](https://www.zero.xyz/host/meterly-ai.vercel.app/llms.txt)