X

Interact with X (Twitter) API

Actions10

User → Lookup by ID

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 ID operation, it allows you to retrieve detailed information about one or more users by their user IDs.

Common scenarios where this node is beneficial include:

  • Fetching profile details of specific users for analytics or monitoring.
  • Enriching datasets with user metadata such as follower counts, verification status, and descriptions.
  • Automating workflows that require user information lookup based on known user IDs.

For example, you can input a comma-separated list of user IDs to get their usernames, public metrics (like follower count), verification status, and descriptions in a single API call.

Properties

Name Meaning
Authentication Method used to authenticate API requests. Options: "OAuth1.0a" or "Bearer Token".
User IDs Comma-separated list of user IDs to look up.

Output

The output JSON contains user objects returned from the X API endpoint /2/users. Each user object 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 node returns an array of these user objects, each wrapped inside an item with a json property.

No binary data output is produced by this operation.

Dependencies

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

Troubleshooting

  • Empty or no results: Ensure the user IDs provided are valid and exist on X. Invalid or suspended user IDs will not return data.
  • Authentication errors: Verify that the API credentials are correctly set up and have the necessary permissions to access user data.
  • Rate limits: The X API enforces rate limits; hitting these may cause errors. Implement retry logic or reduce request frequency.
  • Malformed user IDs: Provide user IDs as a comma-separated string without extra spaces or invalid characters.

Common error messages:

  • "Unauthorized": Check your API credentials and authentication method.
  • "Not Found": One or more user IDs do not exist.
  • "Too Many Requests": Rate limit exceeded; wait before retrying.

Links and References

Discussion