FastFetchz
X

X / Twitter

Posts / User Posts

per_call

Paginated timeline of an account's posts including text, entities (hashtags, mentions, links), attached media, reply/repost/like/bookmark counts, view counts and timestamps. Use it for brand monitoring, newsjacking alerts and engagement benchmarking.

Endpoint

GET /v1/x/posts-user-posts

Price

$0.30

per 1,000 calls · $0.0003 per call

Cost per call

0.2 credits

Failed calls never charged

Parameters

target
required
string

The X / Twitter handle, URL or identifier to resolve.

limit
optional
integer

Items to return for list responses. Default 10, max 100.

cursor
optional
string

Pagination cursor returned by a previous response.

Example request

Sandbox calls return deterministic sample data in the live payload shape.

curl
curl "https://api.fastfetchz.com/v1/x/posts-user-posts?target=nasa" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json
{
  "success": true,
  "service": {
    "platform": "X / Twitter",
    "name": "Posts / User Posts",
    "slug": "posts-user-posts"
  },
  "credits_charged": 0.2,
  "credits_remaining": 99.8,
  "latency_ms": 214,
  "data": {
    "items": [
      {
        "id": "7000493429",
        "shortcode": "SAKQD",
        "url": "https://example.com/x/nasa/493429",
        "caption": "Sandbox posts / user posts item #1 for @nasa.",
        "media_type": "image",
        "like_count": 13629,
        "comment_count": 234,
        "view_count": 494429,
        "duration_sec": 61,
        "taken_at": "2026-08-24T10:34:48.892Z"
      },
      {
        "id": "7000015494",
        "shortcode": "SBYE",
        "url": "https://example.com/x/nasa/15494",
        "caption": "Sandbox posts / user posts item #2 for @nasa.",
        "media_type": "image",
        "like_count": 15694,
        "comment_count": 199,
        "view_count": 16494,
        "duration_sec": 26,
        "taken_at": "2026-08-23T10:34:48.892Z"
      }
    ],
    "paging": {
      "has_more": true,
      "next_cursor": "cursor_40643"
    }
  }
}

Error codes

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedThe key exceeded its monthly cap or the burst limit. Retry later.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.