# AgentUtility Tweet Lookup

> AgentUtility Tweet Lookup is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches full public tweet data by tweet ID(s), returning text, timestamps, metrics, language, and expanded author profiles via X API v2.

## Facts

- Endpoint: POST https://x402.agentutility.ai/tweet-lookup
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-tweet-lookup-8cf98e3d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AjRWh4Kg_aRJSLxv-ZP-d

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 agentutility-tweet-lookup-8cf98e3d -d '<json body>'
```

Example prompt: Can you fetch the full text, author info, and engagement metrics for tweet ID 1234567890123456789?

## When to prefer this

Choose this endpoint when you have one or more specific tweet IDs and need to retrieve full tweet content, metadata, and author profiles without searching. Prefer this over the tweet search endpoint when you already know the exact tweet IDs. Ideal for fact-checking, archiving, citation resolution, or enriching datasets with tweet details.

## Known failure modes

- Tweet ID not found or deleted — returns 404 or empty data response
- Invalid or malformed tweet ID format — returns validation error
- Tweet from suspended or private account — returns access error
- Rate limiting or quota exceeded on the underlying X API — returns 429 or equivalent error
- Payment failure via x402 — request not processed

## How this service works

Tweet lookup API / X tweet lookup / Twitter status lookup by ID. Same read-only X API v2 backend as tweets. Accepts tweet_ids or ids and returns public text, timestamps, metrics, language, and expanded author profiles. No account mutation.

## Output

Returns a JSON object containing the tweet's full text, creation timestamp, language code, public engagement metrics (likes, retweets, replies, impressions), the tweet ID, and an expanded author profile including username, display name, and account metadata.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "tweet_ids"
     ],
     "properties": {
      "ids": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Alias for tweet_ids."
      },
      "mode": {
       "enum": [
        "tweets"
       ],
       "type": "string",
       "description": "Optional. Operation mode; defaults to 'tweets' when tweet_ids/ids are supplied. Accepts search, user, tweets, users, or user_tweets."
      },
      "tweet_ids": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Numeric tweet IDs. Up to 100."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "mode": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "requested": {
       "type": "integer"
      },
      "result_count": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "tweets",
  "source": "X API v2 tweet lookup",
  "requested": 1,
  "result_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-tweet-lookup-8cf98e3d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)