The Vetric Instagram Hashtag Feed Sections component allows you to search and retrieve feed sections based on specific hashtags.

The complete Vetric documentation about their endpoint can be found in their site here.

New to Datastreamer? Start here.

👍
Unify Schema
This data source already use Unify Schema.

API Key

To use this component, you will need a Vetric API key. If you don't have one, please reach out to [email protected] and our team will assist you in obtaining the necessary credentials.

How To Use?

The component is powered by the Jobs System, when interacting with the component you have the option to define your jobs queries.

Search Query

Filters

Filter Name	Description
query	Hashtag IDs to search feed sections for
query_from	Filter dates from/since - Example '2024-05-01T00:00:00Z'
query_to	Filter dates to - Example '2024-08-01T00:00:00Z'
max_documents	Set a limit for the number of documents that will be fetched for the search.
max_excess_documents	When filtering by date, this sets the limit of documents to process that fall outside the date range. This serves as a cost-control measure. Note that costs apply for all retrieved documents, including those that are discarded.

Since the Vetric endpoint does not natively support date filtering, the query_from and query_to filters are applied in memory. Because we cannot guarantee how many documents must be retrieved to find those within the desired date range, the max_excess_documents field can be used to limit the number of documents processed.

Examples

Search for feed sections

Search feed sections for the 'paris' hashtag.

You also have the option to use the API. You can use the Code button to extract this example:

curl --location 'https://api.platform.datastreamer.io/api/pipelines/{PIPELINE_ID}/components/{COMPONENT_ID}/jobs?ready=true' \
      --header 'apikey: <your-api-key>' \
      --header 'Content-Type: application/json' \
      --data \
        '{
          "job_name": "b5c9a33a-6a31-4d69-ada7-c1bf51dc18e7",
          "component_name": "vetric-instagram-hashtag-feed-sections-ingress",
          "data_source": "vetric_instagram_hashtag_feed_sections",
          "query": {
            "include": [
              {
                "data_source": "vetric_instagram_post_comments"
              }
            ],
            "query": "paris",
            "max_excess_documents": 200
          },
          "job_type": "oneTime",
          "query_from": "2025-12-03T00:00:00.000Z",
          "query_to": "2025-12-18T00:00:00.000Z",
          "max_documents": 10
        }'

For more details on creating data collection jobs, see Job Management.

Additional Details

Compatible Metadata Fields

Applicable Metadata Categories	Compatible
Source	Yes
Content	Yes
Author	Yes
Person	No
Enrichment	Yes
Organization	No
Data source-specific fields?	Yes, please see the Metadata page.

Metadata Example

{
    "data_source": "vetric_instagram_hashtag_feed_sections",
    "id": "2624962555020437604",
    "content": {
        "body": "Giornata speciale con primo premio 😀😀 complimenti cognatino 😀😀#golfclubcansiglio #golf #clubhause #copppa #vittoriaincasa",
        "comments_count": 1,
        "likes_count": 11
    },
    "author": {
        "handle": "vania.zaia",
        "profile_image_source": "https://scontent-mia3-1.cdninstagram.com/v/t51.2885-19/441369620_768836825353720_6455514903732147408_n.jpg?stp=dst-jpg_e0_s150x150&_nc_ht=scontent-mia3-1.cdninstagram.com&_nc_cat=104&_nc_ohc=V6zOJ1DVRFYQ7kNvgGgiQeb&edm=AMKDjl4BAAAA&ccb=7-5&oh=00_AYDB-hsxBTrkn-NZIfsQFG6tsk5GxJ4YuXfJmolaoFNyIA&oe=66AD9924&_nc_sid=472314",
        "verified": false,
        "name": "Vania Zaia",
        "userid": "6724690893",
        "id": "6724690893",
        "url": "https://instagram.com/vania.zaia/"
    },
    "instagram": {
        "user_id": "6724690893"
    },
    "facebook": {
        "userid": "17934273703600398"
    }
}

Data collection job creation request

Returns Instagram posts related to a hashtag. The query value is expected to be a hashtag name, can be obtained from hashtag search.

curl --location 'https://api.platform.datastreamer.io/api/pipelines/{PIPELINE_ID}/components/{COMPONENT_ID}/jobs?ready=true' \
      --header 'apikey: <your-api-key>' \
      --header 'Content-Type: application/json' \
      --data \
        '{
			    "job_name": "my instagram data collection",
			    "data_source": "vetric_instagram_hashtag_feed_sections",
			     "query": {
			            "query": "coppa"
			        },
			    "job_type": "oneTime"
				}'

Make sure to replace ‘PIPELINE_ID’ and ‘COMPONENT_ID’ variables to the ones associated with your pipeline.