X Scraper by Lab3 icon

X Scraper by Lab3

Scrape X Data with Lab3
Join our community

Actions7

Overview

This node, named "X Scraper by Lab3," allows users to interact with the social media platform X (formerly Twitter) by performing various tweet and user-related operations. Specifically, for the Quote Tweet operation under the Tweet resource, it enables you to create a quote tweet by adding your own text and optionally attaching media to an existing tweet.

Common scenarios where this node is beneficial include:

  • Automating social media engagement workflows, such as quoting tweets with custom commentary.
  • Integrating X interactions into broader automation pipelines without manual intervention.
  • Attaching media files to quote tweets programmatically.

For example, you can use this node to automatically quote a tweet from a specific user with your own message and an image, helping to streamline marketing or customer engagement tasks.

Properties

Name Meaning
Tweet The tweet to quote. You can specify this either by its ID (e.g., 1187836157394112513) or by URL (e.g., https://x.com/n8n_io/status/1187836157394112513). This identifies the original tweet you want to quote.
Text The text content you want to add to your quote tweet. This is the message that will accompany the quoted tweet.
Options Additional optional fields:
- Media URL: URL of the media to attach to the quote tweet. This media should be previously uploaded via the Upload Media operation.

Output

The output JSON contains the response from the quote tweet action performed on X. It typically includes details about the newly created quote tweet, such as its ID, content, and metadata returned by the platform's API.

If media is attached, the node converts the media URL into a binary buffer before sending it, but the output itself focuses on the JSON response describing the quote tweet.

Dependencies

  • Requires an API key credential with appropriate authentication tokens and cookies for accessing X's private API endpoints.
  • The node depends on the internal scraper library (Eliza class) which handles communication with X using these credentials.
  • Media URLs must point to media already uploaded through a separate Upload Media operation within the workflow.
  • Proper configuration of the API credentials in n8n is mandatory, including guest ID, auth token, and other session cookies.

Troubleshooting

  • Missing Credentials Error: If required authentication tokens or cookies are missing, the node throws an error listing which credentials are absent. Ensure all necessary tokens are provided in the API key credential.
  • Invalid Tweet ID or URL: Providing an incorrect or malformed tweet ID or URL will cause failures. Double-check the tweet identifier format.
  • Media Attachment Issues: If the media URL is invalid or the media was not properly uploaded beforehand, the quote tweet may fail or post without media.
  • API Rate Limits or Access Restrictions: Since the node uses private API endpoints, rate limits or changes in X's API could cause errors. Monitor for any unexpected failures and verify credentials.
  • General Failures: Errors during execution return messages that can be captured if "Continue On Fail" is enabled, allowing partial workflow continuation.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion