# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-modash-io-api-6183fb12/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-modash-io-api-6183fb12/ai_search_influencers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-modash-io-api-6183fb12/get_instagram_influencer_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-modash-io-api-6183fb12/search_influencers_by_email \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-modash-io-api-6183fb12/search_instagram_influencers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-modash-io-api-6183fb12/search_metadata \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-modash-io-api-6183fb12/search_tiktok_influencers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-modash-io-api-6183fb12/search_youtube_influencers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","cursor":"<string>","limit":"<integer>","location":"<string>"}'
```