# Hypeauditor

HypeAuditor provides comprehensive influencer marketing solutions, offering tools for influencer discovery, analytics, and campaign management across multiple social media platforms.

- **Category:** social media marketing
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 4
- **Triggers:** 0
- **Slug:** `HYPEAUDITOR`
- **Version:** 20260223_00

## Tools

### Get Instagram Account Media

**Slug:** `HYPEAUDITOR_GET_ACCOUNT_MEDIA`

Tool to retrieve media content of an Instagram account. Use when you need detailed post-level data and performance metrics for analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `v` | string | No | Optional API version parameter if required by the endpoint (e.g., '2'). |
| `type` | string | No | Social network type. Some deployments require this explicitly. |
| `username` | string | Yes | Instagram account username to retrieve media for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Instagram report

**Slug:** `HYPEAUDITOR_GET_REPORT_INSTAGRAM`

Tool to retrieve a detailed Instagram report. Use after providing username or user_id. Example: GET_REPORT_INSTAGRAM(username="nasa").

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `v` | string | No | API version; only v=2 is supported. |
| `user_id` | string | No | Instagram user ID string. Required if username is not provided. |
| `features` | array | No | List of additional features to include. Allowed values: ranking, mentions, mentioned_by, notable_audience, audience_brand_affinity, er_benchmarks. |
| `username` | string | No | Instagram username without '@'. Required if user_id is not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get TikTok Analytics Report

**Slug:** `HYPEAUDITOR_GET_REPORT_TIK_TOK`

Retrieves comprehensive analytics report for a TikTok account including audience demographics, engagement metrics, content performance, follower growth, and authenticity scores. Use this to analyze TikTok influencers or get detailed insights about a TikTok channel's performance and audience quality.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `v` | string | No | API version string in YYYY-MM-DD format. If not specified, the latest API version is used automatically. Most users should omit this parameter. |
| `channel` | string | Yes | TikTok username (handle) without the '@' symbol. Example: for @littlebig, use 'littlebig'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Influencers by Keyword

**Slug:** `HYPEAUDITOR_SEARCH_INFLUENCERS_SUGGESTER`

Tool to search for influencer social network accounts by keyword. Use when you need to find influencers matching a search term, with optional filtering by social network type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `st` | string ("IG" | "TT" | "YT" | "TW" | "TWI" | "SC") | No | Social network types supported by HypeAuditor |
| `exclSt` | string | No | Social Network Types to exclude from results. Can be a single type (e.g., 'IG') or comma-separated list (e.g., 'IG,TT'). |
| `search` | string | Yes | Search keyword to find influencer accounts (e.g., 'fashion', 'tech', 'fitness') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |