# Surplus Intelligence X/Twitter Tweet Lookup

> Surplus Intelligence X/Twitter Tweet Lookup is a paid API for AI agents from www.surplusintelligence.ai, paid per call via x402, $0.0079/call, status unknown (last checked 2026-09-15).

Fetches tweet data from Twitter/X API v2 by one or more tweet IDs via the Surplus Intelligence proxy

## Facts

- Endpoint: GET https://www.surplusintelligence.ai/x402/api/twitter/v2/tweets
- Price: $0.0079/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/www-surplusintelligence-ai-c6b25a07
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mEQKWUgeuSgly2ocYNVd8

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 www-surplusintelligence-ai-c6b25a07
```

Example prompt: Can you look up the tweet with ID 1234567890123456789 and tell me what it says?

## When to prefer this

Use this endpoint when you have one or more specific tweet IDs and need to retrieve their content or metadata. Prefer this over tweet search when you already know the exact tweet IDs rather than searching by keywords or user. Ideal for agents resolving tweet references found elsewhere (e.g., in URLs or mentions).

## Known failure modes

- Invalid or malformed tweet IDs return error objects in the 'errors' array
- Deleted or suspended tweets may return not-found errors
- Rate limits or quota exhaustion on the upstream Twitter API return 429 or proxy error responses
- Missing required 'ids' query parameter returns a 400-level validation error
- Payment failure via x402 protocol returns 402 Payment Required

## How this service works

X/Twitter API v2 via Surplus Intelligence: Tweet lookup (1 unit)

## Output

Returns a JSON object conforming to the Twitter API v2 tweet lookup response, including a 'data' array with tweet objects (text, id, and requested fields), an optional 'meta' object, and an 'errors' array if any IDs were invalid or not found.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "ids": "1234567890123456789"
  }
 }
}
```

## 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": [
      "ids"
     ],
     "properties": {
      "ids": {
       "type": "string",
       "description": "Comma-separated X/Twitter tweet IDs."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {},
      "meta": {
       "type": "object"
      },
      "errors": {
       "type": "array"
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "errors"
 ],
 "properties": {
  "errors": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "type",
     "title",
     "value",
     "detail",
     "parameter",
     "resource_id",
     "resource_type"
    ],
    "properties": {
     "type": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "value": {
      "type": "string"
     },
     "detail": {
      "type": "string"
     },
     "parameter": {
      "type": "string"
     },
     "resource_id": {
      "type": "string"
     },
     "resource_type": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/www-surplusintelligence-ai-c6b25a07/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.surplusintelligence.ai](https://www.zero.xyz/host/www.surplusintelligence.ai/llms.txt)