# Modash — 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 influencers across Instagram, TikTok, and YouTube by filtering for location, follower count, engagement rates, and other key metrics to identify the perfect creators for your campaigns. Access detailed influencer reports, contact information, and use AI-powered search to discover creators that match your specific needs.

**Category:** Social Media | **Website:** [modash.io/](https://modash.io/) | **Docs:** [parse.bot/marketplace/6183fb12-f095-4f89-872b-c90e791adafa/modash-io-api](https://parse.bot/marketplace/6183fb12-f095-4f89-872b-c90e791adafa/modash-io-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/modash/`
**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

### Ai search influencers

AI-powered natural language search for influencers across platforms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Modash API key |
| `platform` | string | No | Platform: instagram, tiktok, or youtube |
| `query` | string | Yes | Natural language search query (e.g., 'fitness influencers in New York') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/modash/ai-search-influencers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","platform":"<string>","query":"<string>"}'
```

### Get instagram influencer report

Retrieve a full influencer report for a given Instagram userId, including contact information and detailed demographics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Modash API key |
| `user_id` | string | Yes | Instagram user ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/modash/get-instagram-influencer-report \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","user_id":"<string>"}'
```

### Search influencers by email

Lookup influencer accounts associated with a given email address across platforms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Modash API key |
| `email` | string | Yes | Email address to search for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/modash/search-influencers-by-email \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","email":"<string>"}'
```

### Search instagram influencers

Search for Instagram influencers with filters like location, followers, engagement, and contact info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Modash API key |
| `audience_location` | string | No | Comma-separated audience location codes |
| `audience_location_weight` | number | No | Minimum audience percentage in specified locations |
| `cursor` | string | No | Pagination cursor from previous response |
| `engagement_min` | number | No | Minimum engagement rate |
| `followers_max` | integer | No | Maximum follower count |
| `followers_min` | integer | No | Minimum follower count |
| `has_email` | boolean | No | Filter for accounts with email contact |
| `is_verified` | boolean | No | Filter for verified accounts only |
| `limit` | integer | No | Number of results to return |
| `location` | string | No | Comma-separated location codes (e.g., 'US,GB') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/modash/search-instagram-influencers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","audience_location":"<string>","audience_location_weight":"<number>","cursor":"<string>","engagement_min":"<number>","followers_max":"<integer>","followers_min":"<integer>","has_email":"<boolean>","is_verified":"<boolean>","limit":"<integer>","location":"<string>"}'
```

### Search metadata

Search for metadata like locations, topics, languages, brands, interests, or hashtags for a given platform.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Modash API key |
| `metadata_type` | string | No | Type: locations, topics, languages, brands, interests, users, or hashtags |
| `platform` | string | No | Platform: instagram, tiktok, or youtube |
| `query` | string | No | Search query for filtering metadata |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/modash/search-metadata \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","metadata_type":"<string>","platform":"<string>","query":"<string>"}'
```

### Search tiktok influencers

Search for TikTok influencers with filters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Modash API key |
| `cursor` | string | No | Pagination cursor from previous response |
| `followers_min` | integer | No | Minimum follower count |
| `limit` | integer | No | Number of results to return |
| `location` | string | No | Comma-separated location codes |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/modash/search-tiktok-influencers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","cursor":"<string>","followers_min":"<integer>","limit":"<integer>","location":"<string>"}'
```

### Search youtube influencers

Search for YouTube influencers with filters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Modash API key |
| `cursor` | string | No | Pagination cursor from previous response |
| `limit` | integer | No | Number of results to return |
| `location` | string | No | Comma-separated location codes |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/modash/search-youtube-influencers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","cursor":"<string>","limit":"<integer>","location":"<string>"}'
```

## Next steps

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