Guides
Guides
Get Started

Vetric Instagram User Reels

Retrieve Instagram posts from the user's reels

Suggest Edits

The Vetric Instagram User Reels allows you to return posts from the user Reels by the user id.

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

You will need a Vetric API key to use this component. If you don't have one reach out to [email protected] and our team will help you with that.

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 NameDescription
queryInstagram user ID
max_documentsSet a limit for the number of documents that will be fetched for the search.

Examples

Retrieves posts from feed

Get posts from feed of the user with id '3532778'.

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": "{JOB_NAME}",
          "data_source": "vetric_instagram_user_reels",
          "query": {
            "include": [
              {
                "data_source": "vetric_instagram_post_comments"
              }
            ],
            "query": "3532778"
          },
          "job_type": "oneTime",
          "max_documents": 10
        }'

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

Additional Details

Compatible Metadata Fields

Applicable Metadata CategoriesCompatible
SourceYes
ContentYes
AuthorYes
PersonNo
EnrichmentYes
OrganizationNo
Data source-specific fields?Yes, please see the Metadata page.

Metadata Example

{
    "id": "3441162704486222606",
  	"data_source": "vetric_instagram_user_reels",
    "author": {
        "userid": "52049029117",
        "name": "Yolanda Cool",
        "handle": "coolyolanda94",
        "verified": false,
        "profile_image_source": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-19/275792662_659538841960224_164667851919118601_n.jpg?stp=dst-jpg_e0_s150x150&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=100&_nc_ohc=AXkh2VZfZzQQ7kNvgGPnrKP&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AYAt3yf-a9Gge983x9C85NTtGZxyrXogBOdza9fmYgQnsQ&oe=66CE9494&_nc_sid=c024bc",
        "url": "https://www.instagram.com/coolyolanda94"
    },
    "doc_date": "2024-08-23T18:43:37.000Z",
    "content": {
        "published": "2024-08-23T18:43:37.000Z",
        "body": "This is another sample image of a sample https://img.freepik.com/free-vector/science-experiment-with-microscope-sample-analysis-observation_1308-159351.jpg?t=st=1724438519~exp=1724442119~hmac=112284b344167d42b1f2e6c24e02e8ab27cfc8eab31430f08c0c055a08f2e0e6&w=2000",
        "comments_count": 1,
        "likes_count": 0,
        "video": {
            "thumbnail": "https://scontent-dfw5-2.cdninstagram.com/v/t51.29350-15/456866445_1616235655619408_1315866864618743120_n.jpg?stp=dst-jpg_e15_s360x360&cb=9b69d9bc-a3bec4e5&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi4xNDQweDE0NDAuc2RyLmYyOTM1MC5kZWZhdWx0X2NvdmVyX2ZyYW1lIn0&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_ohc=RVbx7QotxzAQ7kNvgFsh5Te&edm=ACHbZRIBAAAA&ccb=7-5&ig_cache_key=MzQ0MTE2MjcwNDQ4NjIyMjYwNg%3D%3D.2-ccb7-5&oh=00_AYBFPcmsSZQ85LC5Z7NCeAc7AOhYsgiQrJhlrmDhzXemeA&oe=66CEA5F8&_nc_sid=c024bc"
        },
        "play_count": 0,
        "video_urls": [
            "https://scontent-dfw5-1.cdninstagram.com/o1/v/t16/f2/m69/An_ZVN1KAHak2B02URUqyZCevDfen6jJAFjn4AnyJ3HvKXnzHy-htvfaemMio7GxlCQ-8eW9iv0vAghvXXaKBgE.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLmMyLjEwODAuYmFzZWxpbmUifQ&_nc_cat=105&vs=1196717384940660_4055298512&_nc_vs=HBkcFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HTThLMHdMaGJHTmswazlmQUVmZ3RlX2VIX1F3YnBSMUFBQUYVAALIAQAoABgAGwAVAAAm0Im0msKvg0AVAigCQzMsF0AjzMzMzMzNGBZkYXNoX2Jhc2VsaW5lXzEwODBwX3YxEQB1%2FgcA&_nc_rid=5686773942&ccb=9-4&oh=00_AYDUUuybenfLj655j3WVAvBUPuHs4NbSgqN5hG6sd886ng&oe=66CAC23E&_nc_sid=c024bc"
        ]
    },
    "instagram": {
        "id": "52049029117"
    },
    "source": {
        "link": "https://www.instagram.com/reel/C_Bdz9nOUsO"
    }
}

Data collection job creation request

Returns Instagram reels posted by given user. The query value is expected to be a valid Instagram User Id.

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_user_reels",
			    "query": {
			            "query": "52049029117"
			        },
			    "job_type": "oneTime"
				}'

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

Including comments

The Vetric Instagram User Reels connector now has an additional feature that allows the inclusion of comments associated with each User Reel post. Users can retrieve up to a specified number of comments for each post.

Data Collection Job Example

This example demonstrates a job query that will fetch up to 10 Instagram User Reels Posts for the user with ID '52049029117'_, and then retrieve up to 5 comments for each of those posts.

📘

Note

You can specify the max_documents parameter to control the volume of data retrieved in both the main and included queries.

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_user_reels",
	"max_documents": 10,
	"query": {
		"query": "52049029117",
		"include": [
			{
				"data_source": "vetric_instagram_post_comments",
				"max_documents": 5
			}
		]
	},
	"job_type": "oneTime"
}'

Important: Replace the PIPELINE_ID and COMPONENT_ID values with those corresponding to your pipeline.

Data Collection Job Results

Once the User Reel posts have been fetched, the query will then retrieve up to 5 comments from the vetric_instagram_post_comments data source for each post. These comments are linked back to the related post by matching the post ID.

Here's an example of the response for the comments retrieved:

{
  "documents": [
    {
      "data_source": "vetric_instagram_post_comments",
      "id": "18019083575265676",
      "author": {
        "userid": "28569666463",
        "handle": "qbangrl13",
        "name": "ɐɯıəʎ",
        "profile_image_source": "https://scontent-dfw5-1.cdninstagram.com/v/t51.2885-19/460686175_1555771215366982_2989984919338633558_n.jpg?stp=dst-jpg_e0_s150x150&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=110&_nc_ohc=pMblR8AEHKQQ7kNvgH7Gvtv&edm=AId3EpQBAAAA&ccb=7-5&oh=00_AYBjMp-YqZZNWAiucGjQbOk6p5Y3SctYV8jCv4PBtn910Q&oe=66FC88F0&_nc_sid=f5838a",
        "verified": false,
        "is_mentionable": false,
        "url": "https://www.instagram.com/qbangrl13"
      },
      "doc_date": "2024-09-23T12:37:44.000Z",
      "content": {
        "published": "2024-09-23T12:37:44.000Z",
        "body": "I have four.. been keeping them since I was a teenager. I love these lil guys ❤️",
        "likes_count": 1,
        "child_comments_count": 0,
        "related_post_id": "3463427961463821516"
      },
      "instagram": {
        "content_type": "comment"
      }
    }
  ]
}

Important: Only a single include object can be requested per query.

Updated 12 days ago