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, for news search_news. 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.

FieldTypeRequiredDescription
typestringnoe.g. "auto". default "auto"
querystringyese.g. "open source vector database written in rust"
categorystringnoFocus on one kind of page: company, people, news, publication, personal site, or financial report (annual reports and filings, mostly of US-listed companies).
contentsobjectnoAttach 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.
numResultsintegernoHow many results, 1 to 10. Default 10. The search itself costs the same for any number.; min 1, max 10
userLocationstringnotwo-letter ISO country code to localise results, e.g. US
excludeDomainsarray of stringno
includeDomainsarray of stringnoonly these hosts or host paths
endPublishedDatestringnoISO 8601
startPublishedDatestringnoISO 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_semantic"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_semantic"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

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:

{
  "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

This page as Markdown: /docs/tools/search_semantic.md. Something wrong or missing: hello@parel.si.