search_places_by_description

Places that match a plain-words description, with address, rating, opening hours and how busy each is hour by hour. ₹0.79 per call; a result that finds nothing is ₹0.

What it does

Places (cafés, restaurants, shops, gyms, venues, offices) that match a description in plain words ("quiet cafés in Indiranagar good for working on a laptop"), up to ten per call. Each of data.results[] has the place's title and text: a short Markdown record with the address, area, map coordinates, whether it is open, its categories, rating and number of reviews, price level where known, opening hours by day, and its popular times (how busy it usually is, hour by hour, and the usual wait).

Use it when the place is easier to describe than to name, or to pick a time or a spot by how busy it is; search_maps lists places for a keyword with phone numbers and websites, search_local returns Google's local pack, get_place reads one known place, and get_maps_reviews its reviews. Flat price per call for up to ten places; an empty result is free.

India: name the area and city in the description; there is no country setting.

Inputs

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

FieldTypeRequiredDescription
querystringyesThe place in plain words, with the area and city ("vegan restaurants in Bandra, Mumbai, open late").
numResultsintegernoHow many places, 1 to 10. Default 10.; min 1, max 10

What drives the cost

Flat price per call for up to ten places (numResults 1 to 10, default 10); an empty result is free. 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 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_places_by_description"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_places_by_description"
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_places_by_description","input":{"query":"vegan restaurants in Bandra, Mumbai, open late","numResults":10}}'

What comes back

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

{
  "results": [
    {
      "title": "Firdos Restaurant",
      "text": "# Firdos Restaurant\n\nFirdos Restaurant is a restaurant in D Block BKC, Naupada, Bandra East, State of Mahārāshtra, India.\n\n## Location\n\n- **Address:** Gound floor Building no.2, Anant Kanekar Marg, near Bandra court, opp. Amber restaurant,…"
    },
    {
      "title": "The Village Shop",
      "text": "# The Village Shop\n\nThe Village Shop is a restaurant in Bandra West, State of Mahārāshtra, India.\n\n## Location\n\n- **Address:** 5AA, Mac Ronells Bungalow, Saint Andrews Ext, next to Learner’s Academy, Bandra West, 400050, India\n- **Area:** B…"
    },
    {
      "title": "Pause - Your Everyday Cafe",
      "text": "# Pause - Your Everyday Cafe\n\nPause - Your Everyday Cafe is a café in Bandra West, State of Mahārāshtra, India.\n\n## Location\n\n- **Address:** Shop No. 27, Vora House, A/B, Pali Mala Rd, Bandra West, 400050, India\n- **Area:** Bandra, State of…"
    }
  ]
}

Notes

  • Each record is Markdown text, cut at a fixed length: location, details and opening hours come first, then popular times.
  • Flat price per call for up to ten places (numResults 1 to 10, default 10); an empty result is free.
  • Describe the place and name the area and city; it does not take a map position or a radius.

Siblings

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