FastFetchz
X

X / Twitter

Search / Trends

per_call

Runs search across X posts with support for operators, result type (top/latest) and language filters, and returns trending topic lists with post volumes for a given location. Built for real-time monitoring and trend research.

Endpoint

GET /v1/x/search-trends

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/search-trends?target=nasa" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json
{
  "success": true,
  "service": {
    "platform": "X / Twitter",
    "name": "Search / Trends",
    "slug": "search-trends"
  },
  "credits_charged": 0.2,
  "credits_remaining": 99.8,
  "latency_ms": 214,
  "data": {
    "query": "nasa",
    "results": [
      {
        "id": "9000085629",
        "type": "profile",
        "title": "nasa result 1",
        "url": "https://example.com/x/result/85629",
        "engagement_score": 62.9,
        "matched_at": "2026-08-25T10:37:01.506Z"
      },
      {
        "id": "9000108010",
        "type": "post",
        "title": "nasa result 2",
        "url": "https://example.com/x/result/108010",
        "engagement_score": 1,
        "matched_at": "2026-08-24T10:37:01.506Z"
      }
    ],
    "paging": {
      "has_more": true,
      "next_cursor": "cursor_s_2"
    }
  }
}

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.