Apex icon

Apex

Manage your social media via Apex.

Actions6

Overview

This node allows users to search tweets on a social media platform using various keywords and filters. It is useful for monitoring topics, tracking brand mentions, gathering market insights, or researching trends by querying tweets that match specific criteria. For example, a marketer could use it to find recent tweets mentioning their product, or a researcher could gather tweets containing certain hashtags within a date range.

Properties

Name Meaning
Search Keyword(s) One or more keywords to include in the tweet search query.
Additional Fields A collection of optional filters and parameters to refine the search:
- Count Number of tweets to fetch (default 10).
- Cursor Pagination cursor for fetching the next batch of results.
- End Date Ending date/time for the search range.
- Exclude Words Words to exclude from the search results.
- From Users List of usernames (without @) whose tweets to search from.
- Hashtags List of hashtags to filter tweets by.
- Include Phrase Specific phrase to search for in tweets.
- Language Language code (ISO 639-1) to filter tweets by language.
- List ID of a list to restrict the search within.
- Max ID Maximum tweet ID to limit the search.
- Mentions List of mentioned usernames to filter tweets that mention them.
- Min Likes Minimum number of likes a tweet must have to be included.
- Min Replies Minimum number of replies a tweet must have to be included.
- Min Retweets Minimum number of retweets a tweet must have to be included.
- Only Links Boolean flag to search only tweets containing links.
- Only Original Boolean flag to search only original tweets (not retweets or replies).
- Only Replies Boolean flag to search only replies.
- Only Text Boolean flag to search only text tweets (no media or links).
- Optional Words Optional words to include in the search query.
- Quoted ID of a quoted tweet to filter tweets quoting it.
- Since ID Starting tweet ID to limit the search.
- Start Date Starting date/time for the search range.
- To Users List of usernames (without @) to whom the tweets must be addressed.
- Top Boolean flag to search for top tweets instead of recent ones.

Output

The node outputs JSON data representing the search results. Each item corresponds to a tweet matching the search criteria, including metadata such as tweet content, author, timestamps, and engagement metrics (likes, retweets, replies). The output does not explicitly mention binary data, so it is assumed to be purely JSON structured data.

Dependencies

  • Requires an API key credential for authenticating with the Apex backend service.
  • The node sends HTTP GET requests to the Apex backend endpoint https://apex-backend-435707161213.us-west1.run.app/apex/tweet/search with query parameters based on user input.
  • No additional external dependencies are indicated.

Troubleshooting

  • Common issues:

    • Invalid or missing API authentication token will cause request failures.
    • Providing invalid date formats or unsupported language codes may result in errors or empty results.
    • Using contradictory filters (e.g., onlyOriginal true and onlyReplies true simultaneously) might yield no results.
    • Pagination cursors (cursor) must be used correctly to fetch subsequent pages.

  • Error messages:

    • Authentication errors typically indicate missing or incorrect API credentials.
    • Validation errors may occur if required fields like searchKeyword are empty or malformed.
    • Rate limiting or quota exceeded errors can happen if too many requests are made in a short time; users should check API usage limits.

Links and References

Discussion