Skip to docs content
Browse and search
On this page

Look up an account

Returns one account's profile.

GET/api/user/{id}

Authorization

  • AuthorizationstringheaderrequiredBearer authentication with your TweetStream API key: Bearer <key>.

Path parameters

  • idstringrequiredNumeric account ID, or a handle with or without @. A handle made only of digits needs the @.

Response fields

  • pinnedTweetobject | nullrequiredThe account's pinned post, with the same fields as tweet in a post lookup. Filled in only for accounts TweetStream has seen pin a post. Null otherwise, after the account unpins, or when the post can't be shown right now.
  • userobjectrequiredThe same fields as author in WebSocket post events.

Responses

  • 200Success
  • 400Invalid account ID or handle
  • 401Missing or invalid API key
  • 403The API key's account has no paid or trialing subscription.
  • 404Account not found
  • 429Rate limit reached (60 lookups per minute per account, in bursts of up to 10) or 4 lookups already in progress for the account
  • 503Lookup or authentication is temporarily unavailable