# Hypeauditor — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/hypeauditor/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/hypeauditor/get-influencer-contact-email \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/hypeauditor/get-influencer-linked-accounts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/hypeauditor/get-instagram-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/hypeauditor/get-top-instagram-influencers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/hypeauditor/search-creator \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.