# Hypeauditor — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find and analyze influencer profiles across Instagram and other platforms with detailed engagement metrics, contact information, and linked social accounts. Search by keyword or location, retrieve profile analytics, and identify top-performing creators to inform influencer marketing decisions.

**Category:** Social Media | **Website:** [hypeauditor.com/](https://hypeauditor.com/) | **Docs:** [parse.bot/marketplace/95acc8cb-2882-4034-8674-8b3f76342248/hypeauditor-com-api](https://parse.bot/marketplace/95acc8cb-2882-4034-8674-8b3f76342248/hypeauditor-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-hypeauditor-com-api-95acc8cb/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_influencer_contact_email

Extract email addresses and phone numbers from an influencer's public Instagram bio/description using pattern matching. Returns empty arrays when the bio contains no contact information. Useful for outreach workflows — not all profiles expose contact details publicly.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Instagram username (without @ prefix). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hypeauditor-com-api-95acc8cb/get_influencer_contact_email \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_influencer_linked_accounts

Find accounts with the same username across Instagram, TikTok, YouTube, and Twitter. Uses HypeAuditor's suggestion API to match the exact username on multiple platforms. Returns all platform presences found for that username with subscriber counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Username to lookup across platforms. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hypeauditor-com-api-95acc8cb/get_influencer_linked_accounts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_instagram_profile

Retrieve detailed public metrics for an Instagram profile. Returns engagement rate, follower growth history, media count, average likes and comments, estimated income, audience geography, blogger rankings, and account metadata. The report is generated from HypeAuditor's public data cache and may lag real-time by hours to days.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Instagram username (without @ prefix). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hypeauditor-com-api-95acc8cb/get_instagram_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_top_instagram_influencers

Retrieve the top Instagram influencers ranking with engagement metrics. Supports pagination via limit and offset, and optional country filtering. Each entry includes basic profile info, subscriber count, average engagement, authentic engagement score, and top audience country. When country is omitted, returns the global ranking. Maximum 1000 entries available; first 50 are free-tier for global, first 10 for country rankings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | ISO 3166-1 alpha-2 country code to filter the ranking to a specific country (e.g. KR, US, BR, DE, FR, JP). When omitted, returns the global ranking. |
| `limit` | integer | No | Maximum number of results to return (max 1000). |
| `offset` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hypeauditor-com-api-95acc8cb/get_top_instagram_influencers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","limit":"<integer>","offset":"<integer>"}'
```

### search_creator

Full-text search for creators by keyword across Instagram, TikTok, YouTube, and Twitter. Returns up to 15 matching profiles with follower counts, platform type, and verification status. The query matches creator names, usernames, and associated keywords. Results are not paginated — a single request returns all matches for the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword such as a creator name, brand name, or topic. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hypeauditor-com-api-95acc8cb/search_creator \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```