# GoCreative Twitter/X User Timeline API

> GoCreative Twitter/X User Timeline API is a paid API for AI agents from api.gocreativeai.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Fetches a Twitter/X user's recent tweets with full engagement metrics (likes, retweets, replies, views) by @handle, no login required

## Facts

- Endpoint: GET https://api.gocreativeai.com/v1/twitter/tweets/user/:var1
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gocreative-twitter-x-user-timeline-api-96cc23b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xOM0cPecYy-niqoFDWmkz

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 gocreative-twitter-x-user-timeline-api-96cc23b0
```

Example prompt: Pull the recent tweets from @elonmusk along with all the engagement metrics — likes, retweets, replies, and views.

## When to prefer this

Choose this endpoint when you need real-time tweet data and engagement metrics for a specific public Twitter/X user without needing an official Twitter API key or OAuth login. Ideal for agent workflows that monitor social media activity, vet influencers, or research public figures, especially when the official Twitter v2 API is cost-prohibitive or access is restricted.

## Known failure modes

- Invalid or non-existent @handle returns an error or empty result
- Private/protected accounts may not return tweets
- Payment failure (x402) if USDC balance is insufficient
- Rate limiting if the endpoint is called too frequently
- Handle URL encoding issues if special characters are present in the username

## How this service works

Twitter / X User Timeline — a specific @handle's recent tweets with full engagement metrics (likes, retweets, replies, views). Real-time, no login. SEO: Twitter user tweets API, X timeline scraper, tweet history, twitter api.

## Output

Returns a list of recent tweets from the specified Twitter/X @handle, each including the tweet text, timestamp, and engagement metrics such as like count, retweet count, reply count, and view count.

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "input"
     ],
     "properties": {
      "input": {
       "type": "string",
       "description": "endpoint argument"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gocreative-twitter-x-user-timeline-api-96cc23b0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gocreativeai.com](https://www.zero.xyz/host/api.gocreativeai.com/llms.txt)