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.
| 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
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
search_webwhen you need Google's own ranking.read_pageto read any result in full.
This page as Markdown: /docs/tools/search_semantic.md. Something wrong or missing: hello@parel.si.