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

# search_semantic

> Meaning-based web search: describe the page you want and get pages that match the idea, not the exact words. ₹0.79 per call for up to ten results; an empty result list is ₹0.

## What it does

Describe the page you want ("startups building battery swapping for two-wheelers in India") and get pages that match the idea rather than the exact words, in `data.results[]` with `url`, `title` and, where the source has them, `author`, `publishedDate` and a score; results in the `company` category carry an `entities` block with the company's name, founding year and description. Use it to find companies, people, papers, blog posts and competitors when Google's keyword results are noisy; for exact Google rankings use [`search_web`](https://parel.si/docs/tools/search_web.md), for news [`search_news`](https://parel.si/docs/tools/search_news.md). Narrow with `category` (`company`, `people`, `news`, `publication`), `includeDomains`, `excludeDomains` and a published-date range; `contents` can attach page text or highlights to each result, which makes the response large.

India: there is no country knob. Put the place in the query, or set `userLocation` to `"IN"`.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `type` | string | no | e.g. "auto". default "auto" |
| `query` | string | yes | e.g. "open source vector database written in rust" |
| `category` | string | no | Focus on one kind of page: company, people, news, publication, personal site, or financial report (annual reports and filings, mostly of US-listed companies). |
| `contents` | object | no | Attach page content to each result: {text: true\|{maxCharacters}, highlights: true\|{query, maxCharacters}, summary: {query}}. Text and summaries are charged per page on top of the search, so a call that asks for them can settle above the price shown or be refused as estimate_too_low; text also makes the answer large. Prefer highlights. |
| `numResults` | integer | no | How many results, 1 to 10. Default 10. The search itself costs the same for any number.; min 1, max 10 |
| `userLocation` | string | no | two-letter ISO country code to localise results, e.g. US |
| `excludeDomains` | array of string | no |  |
| `includeDomains` | array of string | no | only these hosts or host paths |
| `endPublishedDate` | string | no | ISO 8601 |
| `startPublishedDate` | string | no | ISO 8601; only pages published after this |

## What drives the cost

Nothing: the price is flat per call for up to ten results. `numResults` is 1 to 10 here (default 10); a larger number is `invalid_input`, ₹0. Ask for ten.

## 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_semantic"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_semantic"` |
| 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_semantic","input":{"query":"D2C skincare brands in India that raised funding in 2025","category":"company","numResults":10}}'
```

## What comes back

`data.results[]`, one row per page. A real answer recorded during the live check of 2026-10-28 (five results asked for), trimmed to two:

```json
{
  "resolvedSearchType": "",
  "results": [
    {
      "title": "Innovist",
      "url": "https://innovist.com/",
      "image": "https://media.licdn.com/dms/image/v2/C4D0BAQGlb-SYO-DKrA/company-logo_200_200/company-logo_200_200/0/1654756013773/bare_anatomy_logo",
      "entities": [
        {
          "type": "company",
          "version": 1,
          "properties": {
            "name": "Innovist",
            "foundedYear": 2018,
            "description": "Innovist is synonymous to all things Clean, Transparent, and Scientific. A one-stop shop for products with proven efficacy!\nWhen one shops at Innovist, they invest in genuinity. We are proud to own the entire process of Research & Development, Manufacturing and Clinical Trials, which equips us to serve every customer with Certified, Safe, and High Quality pr…",
            "workforce": {
              "total": 250
            },
            "headquarters": {
              "address": "Gurgaon, Haryana 122016, IN",
              "city": "Gurgaon",
              "postalCode": null,
              "country": "India"
            },
            "financials": {
              "revenueAnnual": 1600000,
              "fundingTotal": 35065963,
              "fundingLatestRound": {
                "name": "Series b",
                "date": "2025-05-07",
                "amount": 15899999
              }
            },
            "webTraffic": {
              "visitsMonthly": 2363736,
              "countryRank": 2068,
              "avgDurationSeconds": 112,
              "history": [
                {
                  "value": 2447910,
                  "dateFrom": "2026-05",
                  "dateTo": "2026-05"
                },
                {
                  "value": 2523627,
                  "dateFrom": "2026-06",
                  "dateTo": "2026-06"
                },
                "… 4 more item(s) truncated"
              ]
            },
            "research": null
          }
        }
      ]
    },
    {
      "title": "Foxtale",
      "url": "https://foxtale.in/",
      "image": "https://media.licdn.com/dms/image/v2/D4D0BAQEw7my9XVtA_A/company-logo_200_200/B4DZ_1KerfJIAE-/0/1786524593123/foxtale_skin_logo",
      "entities": [
        {
          "type": "company",
          "version": 1,
          "properties": {
            "name": "Foxtale",
            "foundedYear": 2021,
            "description": "Featured in: Forbes Asia's 100 To Watch\n\nCheck out Hula Hoop by Foxtale here- https://foxtale.in/hulahoop \n\nBefore starting Foxtale, Romita Mazumdar spoke to 3000+ women to understand their concerns and expectations from skincare. Inspired by these tales of these women, Foxtale was founded in December 2021. \n\nFoxtale is a performance-first skincare brand tha…",
            "workforce": {
              "total": 336
            },
            "headquarters": {
              "address": "MIDC Road, Ackruti Trade Centre, Mumbai, Maharashtra 400059, IN",
              "city": "Mumbai",
              "postalCode": null,
              "country": "India"
            },
            "financials": {
              "revenueAnnual": 20940150,
              "fundingTotal": 67149272,
              "fundingLatestRound": {
                "name": "Series c",
                "date": "2025-01-15",
                "amount": 30000000
              }
            },
            "webTraffic": {
              "visitsMonthly": 4105475,
              "countryRank": 1382,
              "avgDurationSeconds": 129,
              "history": [
                {
                  "value": 5717804,
                  "dateFrom": "2026-05",
                  "dateTo": "2026-05"
                },
                {
                  "value": 4157610,
                  "dateFrom": "2026-06",
                  "dateTo": "2026-06"
                },
                "… 4 more item(s) truncated"
              ]
            },
            "research": null
          }
        }
      ]
    },
    "… 3 more item(s) truncated"
  ],
  "searchTime": 2630.7
}
```

## Notes

- Flat price per call for up to ten results; numResults above 10 is refused as invalid_input (free).
- Phrase the query as a description of the page, not a keyword list.
- contents.text adds page text to every result and makes the response large; prefer highlights.
- No country filter: name the place in the query or set userLocation "IN".

## Siblings

- [`search_web`](https://parel.si/docs/tools/search_web.md) when you need Google's own ranking.
- [`read_page`](https://parel.si/docs/tools/read_page.md) to read any result in full.
