Bistagram icon

Bistagram

Your professional tool for monitoring and analyzing content for your business
Join our community

Actions2

Overview

This node, named Bistagram, is designed for searching posts on a social media platform. It supports both simple and advanced search types, allowing users to find posts based on keywords, hashtags, specific usernames, post types, languages, date ranges, and sorting preferences. It is useful for businesses or individuals who want to monitor and analyze social media content relevant to their interests or brand. For example, a marketing team could use it to track posts containing certain hashtags or keywords, filter by post type (image, video, carousel), and sort results by popularity or recency.

Use Case Examples

  1. Search posts containing specific keywords using the simple search type.
  2. Perform an advanced search to include, exclude, or require certain keywords, filter by hashtags, post type, language, and date range.
  3. Sort search results by like count, comment count, or date created to prioritize relevant content.

Properties

Name Meaning
Search Type Determines whether the search is simple or advanced, affecting which keyword fields are used.
Simple Keywords Comma-separated keywords for simple search type to find posts containing these terms.
Advanced Include Keywords Comma-separated keywords that must be included in the posts for advanced search.
Advanced Exclude Keywords Comma-separated keywords that must not be present in the posts for advanced search.
Advanced Required Keywords Comma-separated keywords that are preferred or required in the posts for advanced search.
Filters Toggle to enable additional filtering options such as specific page, hashtags, post type, language, date range, and sorting.
Specific Page Filter posts from a specific username (page) when filters are enabled.
Hashtags Comma-separated hashtags to filter posts by when filters are enabled.
Post Type Filter posts by type: unknown, image, video, or carousel when filters are enabled.
Language Filter posts by language: all, Persian, English, or Arabic when filters are enabled.
Start Date Filter posts created after this date when filters are enabled.
End Date Filter posts created before this date when filters are enabled.
Sort By Sort posts by like count, comment count, or date created when filters are enabled.
Request Options Additional request settings such as batching, SSL certificate validation, proxy, and timeout.

Output

JSON

  • mustQuery - Array of keywords that must be included in the search.
  • mustNotQuery - Array of keywords that must be excluded from the search.
  • shouldQuery - Array of keywords that are preferred or required in the search.
  • username - Username filter for posts from a specific page.
  • hashtags - Array of hashtags to filter posts.
  • postType - Numeric code representing the type of post (unknown, image, video, carousel).
  • languageType - Numeric code representing the language filter for posts.
  • fromDate - Timestamp representing the start date filter for posts.
  • toDate - Timestamp representing the end date filter for posts.
  • postsSortByType - Numeric code representing the sorting criteria for posts.
  • Pagination
    • pageSize - Number of posts to retrieve per page (fixed at 500).
    • pageNumber - Page number for pagination (starts at 0).

Dependencies

  • An API key credential for authentication with the Bistagram API

Troubleshooting

  • Ensure the API key credential is correctly configured and has necessary permissions to access the Bistagram API.
  • Check that the date filters (Start Date and End Date) are valid and that the Start Date is not after the End Date.
  • If no results are returned, verify that the keywords, hashtags, and filters are correctly specified and match existing posts.
  • Timeout errors may occur if the server is slow to respond; consider increasing the Timeout setting in Request Options.
  • If SSL certificate validation fails, enabling 'Ignore SSL Issues' may help, but use with caution due to security risks.

Links

Discussion