# AgentUtility Tweets by ID Lookup

> AgentUtility Tweets by ID 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 public tweet text, engagement metrics, and author context for one or more Twitter/X post IDs in bulk

## Facts

- Endpoint: POST https://x402.agentutility.ai/tweets-by-id
- 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-tweets-by-id-lookup-1f0ee1a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VpfgrerVqHzlncNncPbrp

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-tweets-by-id-lookup-1f0ee1a8 -d '<json body>'
```

Example prompt: I have a list of tweet IDs — 1823456789012345678, 1823456789012345679, 1823456789012345680 — can you fetch the full text, like counts, retweet counts, and author usernames for all of them?

## When to prefer this

Choose this endpoint when you already have specific tweet IDs and need to retrieve their full content, metrics, and author data in one bulk call. It is ideal for hydrating IDs collected from prior searches, scrapes, or references — avoiding the need to re-search. Prefer this over a tweet search endpoint when you know exactly which tweets you want and need reliable direct lookup rather than keyword-based discovery.

## Known failure modes

- Invalid or malformed tweet ID returns an error or null entry for that ID
- Deleted or suspended tweet returns not-found error
- Private/protected account tweets return access-denied error
- Rate limits or upstream Twitter API errors may cause partial or full failure
- Payment failure via x402 protocol blocks the request entirely
- Empty ID list or missing required parameter returns 400 bad request

## How this service works

Tweets by ID API / bulk Twitter tweet lookup / X post IDs lookup. Same backend as tweets, listed for agents that already have tweet IDs and need public text, metrics, and author context.

## Output

Returns a list of hydrated tweet objects for each input ID, including the full public tweet text, engagement metrics (likes, retweets, replies, impressions), author username, display name, and account metadata. Tweets that are deleted, private, or invalid return an appropriate error or null entry per ID.

## 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": [
      "ids"
     ],
     "properties": {
      "ids": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Numeric X/Twitter tweet IDs. Up to 100."
      },
      "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": "Alias for ids."
      }
     }
    },
    "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": 2,
  "result_count": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-tweets-by-id-lookup-1f0ee1a8/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)