ScrapeCreatorsInstall

Summary

Scrape posts from a selected social media platform, with optional username and date-range filters, and pagination controls.

Inputs

• platform — The social media platform to scrape from. Options: Instagram, Twitter, TikTok, YouTube. Defaults to Instagram. Passed as a query parameter to the API request routing: qs.platform={{$value}}.
• username — Filter posts by username. Passed as a query parameter: qs.username={{$value}}. Default is empty (no filter).
• dateRange — Filter results by start and end date. Collection with two dateTime fields: startDate (filter results from this date) and endDate (filter results until this date). Both default to empty (no date filter).
• returnAll — Whether to return all results or only up to a given limit. Boolean, default false. When true, pagination is disabled and all available posts are returned; when false, the limit parameter controls the maximum number of results.
• limit — Maximum number of results to return. Integer, minimum 1, maximum 1000, default 50. Only active when returnAll is false. Passed as a query parameter: qs.limit={{$value}}.

Output shape

An array of post objects from the specified platform, capped by the limit parameter when returnAll is false, or all available posts when returnAll is true.

Routing sends the limit as a query parameter and returns maxResults in the output. Date-range and username filters are passed as query parameters. Platform is required and routed as qs.platform.

Examples

Example 1: Get up to 20 recent Instagram posts

platform: Instagram, limit: 20, returnAll: false

Example 2: Get all Twitter posts by a specific user between two dates

platform: Twitter, username: example_user, dateRange: { startDate: ..., endDate: ... }, returnAll: true

Links

• n8n community nodes installation guide