X

Interact with X (Twitter) API

Actions10

User → Lookup by Username

AI-generated

Overview

This node interacts with the X (formerly Twitter) API to perform various actions related to users, tweets, and media. Specifically, for the User resource with the Lookup by Username operation, it allows you to retrieve detailed information about a user by providing their username.

Common scenarios where this node is beneficial include:

  • Fetching user profile details such as ID, username, verification status, description, and public metrics.
  • Integrating user data into workflows for analytics, monitoring, or personalized content delivery.
  • Automating social media management tasks that require user information lookup.

Example:
You want to get the profile details of a Twitter user by their username to analyze their follower count and engagement metrics before deciding to follow or interact with them.

Properties

Name Meaning
Authentication Method of authenticating with the X API. Options: OAuth1.0a, Bearer Token
Username The username of the user to look up

Output

The output JSON contains the user data returned from the X API endpoint /2/users/by. This includes fields such as:

  • id: The unique identifier of the user.
  • username: The user's handle.
  • public_metrics: Metrics like follower count, following count, tweet count, etc.
  • verified: Boolean indicating if the user is verified.
  • description: The user's profile description.

The output is structured as an object under the json key for each input item processed.

Dependencies

  • Requires authentication credentials for the X API, either via OAuth 1.0a or Bearer Token.
  • Uses helper functions to make authenticated HTTP requests to the X API endpoints.
  • No additional external dependencies beyond the configured API credentials.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication tokens will cause authorization errors.
    • Providing a non-existent or misspelled username will result in no user data found.
    • Rate limits imposed by the X API may cause request failures if exceeded.

  • Error messages:

    • "Unauthorized": Check that your API credentials are valid and have the necessary permissions.
    • "User not found" or empty response: Verify the username is correct and exists on X.
    • "Rate limit exceeded": Wait and retry after some time or optimize request frequency.

Links and References

Discussion