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

# search_threads

> Threads posts for a keyword: text, likes, reshares, replies and author. ₹0.28 per call; a result that finds nothing is ₹0.

## What it does

Posts on Threads matching a keyword: data with about ten posts, each with the text, like, reshare and reply counts, the author and a link; start_date and end_date set a window.

Use it to see what people say about a brand on Meta's text platform; [`get_threads_posts`](https://parel.si/docs/tools/get_threads_posts.md) for one account, [`get_threads_profile`](https://parel.si/docs/tools/get_threads_profile.md) for its numbers, [`search_x`](https://parel.si/docs/tools/search_x.md) for the same on X. Flat price per call; nothing matching is free. Two to six seconds.

India: Threads is open in India and growing; Indian creators and brands appear for Indian keywords.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The keyword. |
| `end_date` | string | no | Latest post date, YYYY-MM-DD. |
| `start_date` | string | no | Earliest post date, YYYY-MM-DD. |

## What drives the cost

Flat per call for about ten posts; use the date window to page through time. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.28** per call (`cost_paise: 28`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (`hold_paise: 42`); 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_threads"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_threads"` |
| 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_threads","input":{"query":"mamaearth"}}'
```

## What comes back

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

```json
{
  "posts": [
    {
      "id": "3880849522703904944_80428383401",
      "pk": "3880849522703904944",
      "caption": {
        "text": "Comment for the form link 🔗\n\n@mamaearth.in\n\nMamaearth, skincare, affordable finds, trending, viral, pr, Collab, campaign, Insta goods \n\n #reels #explorepage #budget2026 #affordable #mamaearth",
        "pk": "18064911098361910",
        "has_translation": null
      },
      "code": "DXbjBRLgrCw",
      "like_count": 107,
      "taken_at": 1776853343,
      "user": {
        "pk": "80428383401",
        "profile_pic_url": "(picture link removed)",
        "hd_profile_pic_versions": null,
        "username": "a_user_75",
        "friendship_status": null,
        "id": "80428383401",
        "full_name": "A User 76",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": false,
        "has_onboarded_to_text_post_app": true,
        "text_post_app_is_private": false
      },
      "url": "https://www.threads.com/@debosmita_glow_lab/post/DXbjBRLgrCw"
    },
    {
      "id": "3997536496265413579_32356157607",
      "pk": "3997536496265413579",
      "caption": {
        "text": "That Glow ?? Is not filter ✨\n\n🎀This mamaearth Vitamin C 🍊 daily \nGlow✨ cream literally melted into \nMy skin in 5secs !\n\nNo White cast , Instant bright skin \n💛\n\nHave you tried it yet ?\n\n#mamaearth #vitaminCcream\n#dailyglow  #skincareindia…",
        "pk": "18127282954647023",
        "has_translation": null
      },
      "code": "Dd6GkN0j0PL",
      "like_count": 1,
      "taken_at": 1790763509,
      "user": {
        "pk": "32356157607",
        "profile_pic_url": "(picture link removed)",
        "hd_profile_pic_versions": null,
        "username": "a_user_77",
        "friendship_status": null,
        "id": "32356157607",
        "full_name": "A User 78",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": false,
        "has_onboarded_to_text_post_app": true,
        "text_post_app_is_private": false
      },
      "url": "https://www.threads.com/@navi_ugc/post/Dd6GkN0j0PL"
    },
    {
      "id": "3873142295452790195_34600820373",
      "pk": "3873142295452790195",
      "caption": {
        "text": "🚨 Paid Collaboration Alert 🚨\n\nBrand: Mamaearth\nPlatform: Instagram\n\n🎯 Requirements:\n• Minimum 100+ followers\n• Good engagement (active audience preferred)\n\n📦 Deliverables:\n• 1 Reel\n• 2 Stories\n\n💰 Budget:\n₹2,500 (Fixed) + Products\n\n✨ Pe…",
        "pk": "18140804500507629",
        "has_translation": null
      },
      "code": "DXAKmWdAS2z",
      "like_count": 239,
      "taken_at": 1775934563,
      "user": {
        "pk": "34600820373",
        "profile_pic_url": "(picture link removed)",
        "hd_profile_pic_versions": null,
        "username": "a_user_79",
        "friendship_status": null,
        "id": "34600820373",
        "full_name": "Collabify | Creator Network",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": false,
        "has_onboarded_to_text_post_app": true,
        "text_post_app_is_private": false
      },
      "url": "https://www.threads.com/@collabify.ic/post/DXAKmWdAS2z"
    }
  ]
}
```

## Notes

- Flat per call for about ten posts; use the date window to page through time.
- Answers are trimmed to the useful fields.
- Nothing matching is free.

## Siblings

- [`get_threads_posts`](https://parel.si/docs/tools/get_threads_posts.md)
- [`get_threads_profile`](https://parel.si/docs/tools/get_threads_profile.md)
- [`search_x`](https://parel.si/docs/tools/search_x.md)
