---
updatedAt: 2026-08-19T21:24:26.000Z
agentTools:
  projectIndex: https://docs.datastreamer.io/llms.txt
---

# 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](https://docs.vetric.io/#a49de61f-0666-4fab-9755-4e355d89b9a5).

New to Datastreamer? [Start here](https://docs.datastreamer.io/docs/getting-started-1).

> 👍 Unify Schema
>
> This data source already use [Unify Schema](https://docs.datastreamer.io/docs/metadata-fields).

# API Key

To use this component, you will need a Vetric API key. If you don't have one, please reach out to <support@datastreamer.io> and our team will assist you in obtaining the necessary credentials.

# How To Use?

The component is powered by the [Jobs System](https://docs.datastreamer.io/docs/about-jobs), when interacting with the component you have the option to define your jobs queries.

## Search Query

### Filters

| Filter Name        | Description                                                                  |
| :----------------- | :--------------------------------------------------------------------------- |
| **query**          | Hashtag to search posts                                                      |
| **max\_documents** | Set 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.

<Image align="center" className="border" width="50% " border={true} src="https://files.readme.io/3771299ce0e385a3460c1ffaa9e597ecee4e9cf3947b78c0ed2a05f2f40657cd-image.png" />

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

```c JSON
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](https://docs.datastreamer.io/docs/connector-automation).

# Additional Details

## Compatible [Metadata Fields](https://docs.datastreamer.io/docs/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 ](https://docs.datastreamer.io/docs/metadata-fields#instagram-specific-fields)page. |

## Metadata Example

```c JSON
{
    "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.

```c JSON
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.