> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_creators

# search_creators

> Creators and influencers by description on YouTube, Instagram, X or Twitch: profile or post link and the lines that matched. ₹0.79 per call; a result that finds nothing is ₹0.

## What it does

Creators and influencers found by describing them in words ("Indian beauty creators reviewing affordable skincare in Hindi") on one platform you pin with includeDomains: data.results[] with url (a channel, profile or post on that platform), title and highlights[], the caption, bio or transcript lines that matched. Take the handle from the url and dedupe on it, because the same creator can appear through several posts.

Use it to build a creator shortlist by niche, city, language or the brands they mention; then [`get_youtube_channel`](https://parel.si/docs/tools/get_youtube_channel.md), [`get_instagram_profile`](https://parel.si/docs/tools/get_instagram_profile.md) or [`get_x_profile`](https://parel.si/docs/tools/get_x_profile.md) for the numbers, and [`search_instagram_users`](https://parel.si/docs/tools/search_instagram_users.md) when you have a keyword rather than a description. It returns no follower counts or contact details. Flat price per call for up to ten results (numResults 1 to 10, default 10); an empty result list is free. Two to three seconds.

India: YouTube is the richest platform for Indian creators in the live check (Hindi and English reviewers came back); Instagram answered empty for two Indian queries, so try YouTube first.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The creators in words: niche, city or region, language, audience, brand mentions ("Indian beauty creators reviewing affordable skincare in Hindi"). |
| `numResults` | integer | no | How many creators, 1 to 10. Default 10.; min 1, max 10 |
| `includeDomains` | array of string | yes | The platform to search: ["youtube.com"], ["instagram.com"], ["x.com"] or ["twitch.tv"]. |

## What drives the cost

Flat per call for up to ten results; numResults above 10 is refused as invalid_input (free). A search almost always returns something, even for a nonsense query, so judge the results. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.79** per call (`cost_paise: 79`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹1.19 (`hold_paise: 119`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_creators"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_creators"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_creators","input":{"query":"Indian beauty creators reviewing affordable skincare products","numResults":10,"includeDomains":["youtube.com"]}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "results": [
    {
      "id": "https://www.youtube.com/watch?v=rlJsv1hr7kw",
      "title": "Plum Niacinamide Serum Review | Best Budget Serum in India? Honest Results",
      "url": "https://www.youtube.com/watch?v=rlJsv1hr7kw",
      "publishedDate": "2026-03-18T14:12:37.000Z",
      "author": "Arundhati Chakraborty",
      "highlights": [
        "About the product:\nPlum Niacinamide Serum claims to control oil, reduce acne marks, and improve skin texture — all at an affordable price. But does it\n...\n⚡ Honest Verdict:\nOne of the best budget-friendly niacinamide serums in India… but no…"
      ]
    },
    {
      "id": "https://www.youtube.com/watch?v=US8gsa4BcCA",
      "title": "Indian SKINCARE Gems Under ₹500 🤑- PART 2✌🏻",
      "url": "https://www.youtube.com/watch?v=US8gsa4BcCA",
      "author": "Archee Gupta",
      "highlights": [
        "्रेडिएंट्स, दिस हैज़ नाइसेमाइड, ऑफ कोर्स, क्वेलिन ... ठीक है, अच्छा है, बैरियर बिल्डिंग के लिए अच्छा है। दिस हैज़ ... ज़ बिटेन। ठीक है, सब कुछ अब तक अच्छा चल रहा है ... फ फॉर्मूला। पर्सनली, मैं जब भी इसको लगाना स्टार्ट करती हूं, आई डू फी"
      ]
    },
    {
      "id": "https://www.youtube.com/watch?v=9B3FACcNcdM",
      "title": "Best affordable serums 😱 Under ₹500 || Indian Skincare",
      "url": "https://www.youtube.com/watch?v=9B3FACcNcdM",
      "author": "Nishitha Mallur",
      "highlights": [
        "10 for the packaging up next we have the 10 percent vitamin c e f booster serum now as the name ... s talk about this one by one vitamin c helps you get radiant and brighter looking skin while vitamin e is known to nourish and give you"
      ]
    }
  ]
}
```

## Notes

- Flat per call for up to ten results; numResults above 10 is refused as invalid_input (free). A search almost always returns something, even for a nonsense query, so judge the results.
- Pin one platform with includeDomains; several posts can point at the same creator, so dedupe on the handle in the url.
- YouTube answered well for Indian creators in the live check; Instagram came back empty for two Indian queries. No follower counts here: get_youtube_channel and get_instagram_profile have them.

## Siblings

- [`get_youtube_channel`](https://parel.si/docs/tools/get_youtube_channel.md)
- [`get_instagram_profile`](https://parel.si/docs/tools/get_instagram_profile.md)
- [`get_x_profile`](https://parel.si/docs/tools/get_x_profile.md)
- [`search_instagram_users`](https://parel.si/docs/tools/search_instagram_users.md)
