Get Started

Vetric Instagram Hashtag Search

Search for Instagram posts using a hashtag

The Vetric Instagram Hashtag Search allows you to search posts by hashtag.

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 NameDescription
queryHashtag to search posts
max_documentsSet a limit for the number of documents that will be fetched for the search.

Examples

Search for posts using a hashtag

Search posts for the 'arduino' 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": "{JOB_NAME}",
          "data_source": "vetric_instagram_hashtag_search",
          "query": {
            "query": "arduino"
          },
          "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

{
    "data_source": "vetric_instagram_hashtag_search",
    "id": "17843641954062869",
    "content": {
        "body": "copppaljuvenil",
        "challenge_id": "1",
        "media_count": 310
    }
}

Data collection job creation request

Returns Instagram hashtags matching a keyword. The query value is expected to be keyword to search hashtags on Instagram.

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

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