Saves a hunt alert for this query after the seeker agrees to share their email with partners whose listings match, and emails them when a home matches. Requires consent true. Does not accept a phone number. A phone is shared later only on the website, and only with the partner whose property the seeker shortlists. Creates a seeker account when the email is new. An email that already has an account is not attached from this tool; the hunt stays pending until that person confirms it. Verify your phone so matching partners can reach you.
View input schema
{
"type": "object",
"properties": {
"consent": {
"type": "boolean",
"description": "True only when the seeker has explicitly agreed, for this query, to share this email with partners whose listings match. This is not consent to share a phone number."
},
"email": {
"type": "string",
"maxLength": 120,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Email the seeker agreed to share"
},
"name": {
"description": "Seeker display name",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"hunt_name": {
"description": "Optional label for the saved hunt",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"city": {
"type": "string",
"enum": [
"pune",
"ho-chi-minh",
"bangkok",
"hanoi",
"da-nang",
"phuket",
"dubai",
"sharjah"
],
"description": "City slug"
},
"stay_nights": {
"anyOf": [
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 14
},
{
"type": "number",
"const": 30
},
{
"type": "number",
"const": 60
},
{
"type": "number",
"const": 90
},
{
"type": "number",
"const": 180
},
{
"type": "number",
"const": 330
},
{
"type": "number",
"const": 365
}
],
"description": "Desired stay length in nights (7=1 week … 330=11 months, 365=12 months). 11 months is offered everywhere; it is the standard residential lease in India."
},
"price_max": {
"description": "Max monthly rent in `currency` units. Defaults to the city's local currency (Pune INR, Dubai/Sharjah AED, Bangkok/Phuket THB, Vietnam VND). Example: 30000 INR, 4000 AED.",
"type": "number",
"minimum": 100,
"maximum": 500000000
},
"currency": {
"description": "Budget currency for price_max. Defaults to the city's local currency. USD rates are the live cached interbank quote. Saved alerts store the USD equivalent.",
"type": "string",
"enum": [
"INR",
"USD",
"EUR",
"GBP",
"AED",
"THB",
"VND"
]
},
"bedrooms_min": {
"type": "integer",
"minimum": 0,
"maximum": 5
},
"furnished": {
"description": "Set true only when the seeker explicitly asks for furnished. Omit for any furnishing.",
"type": "boolean"
},
"pet_friendly": {
"description": "True only when pets are required. Omit or false means not required, not excluded.",
"type": "boolean"
},
"near_transit": {
"description": "True only when near transit is required. Omit or false means not required, not excluded.",
"type": "boolean"
},
"near_coworking": {
"description": "True only when near coworking is required. Omit or false means not required, not excluded.",
"type": "boolean"
},
"available_by": {
"description": "Move-in by date, YYYY-MM-DD",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"locality": {
"description": "Exact area inside the city, such as Baner or Kharadi. A Baner search does not return Hinjewadi.",
"type": "string",
"minLength": 2,
"maxLength": 80
},
"lock_in_max": {
"description": "Max lock-in months the seeker will accept",
"type": "integer",
"minimum": 0,
"maximum": 24
},
"deposit_months_max": {
"description": "Max security deposit in months of rent",
"type": "number",
"minimum": 0,
"maximum": 12
},
"attached_bath": {
"description": "True only when an attached bath is required. Omit or false means not required, not excluded.",
"type": "boolean"
},
"has_ac": {
"description": "True only when AC is required. Omit or false means not required, not excluded.",
"type": "boolean"
},
"no_curfew": {
"description": "True when the seeker needs no gate curfew. Omit or false means not required, not excluded.",
"type": "boolean"
},
"has_lift": {
"description": "True only when a lift or elevator is required. Omit or false means not required, not excluded.",
"type": "boolean"
},
"area_min": {
"description": "Optional minimum apartment size. Pair with area_unit. Omit for any size.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100000
},
"area_unit": {
"description": "Unit for area_min. Use sqft in Pune and sqm in other cities. Defaults from the city when area_min is set and this is omitted.",
"type": "string",
"enum": [
"sqft",
"sqm"
]
},
"status": {
"description": "Household: Single, Couple, or Family (values single, partner, or family). single matches Everyone and Singles only. partner is Couple and matches Everyone and Couples. family matches Everyone and Families only.",
"type": "string",
"enum": [
"single",
"partner",
"family"
]
},
"has_pets": {
"description": "True when the seeker has pets. Excludes homes that explicitly disallow pets. Unknown pet policy still appears as ask about pets.",
"type": "boolean"
},
"accommodation": {
"description": "Legacy stay type after city. Prefer property_type. pg starts the PG filter path (no bedroom/BHK filters). whole_home is a standard apartment hunt. Omit for any category.",
"type": "string",
"enum": [
"pg",
"whole_home"
]
},
"property_type": {
"description": "Apartment vs PG / co-living after city. When pg, use sharing, gender, rent_min/rent_max per bed, meals_included, attached_bath, ac, suits, amenities — not bedrooms_min.",
"type": "string",
"enum": [
"apartment",
"pg"
]
},
"sharing": {
"description": "PG sharing types (multi-select).",
"type": "array",
"items": {
"type": "string",
"enum": [
"private",
"twin",
"triple",
"4plus"
]
}
},
"gender": {
"description": "PG gender filter.",
"type": "string",
"enum": [
"boys",
"girls",
"coed"
]
},
"rent_min": {
"description": "PG min rent per bed per month (INR).",
"type": "number",
"minimum": 0,
"maximum": 500000
},
"rent_max": {
"description": "PG max rent per bed per month (INR).",
"type": "number",
"minimum": 0,
"maximum": 500000
},
"rent_bracket": {
"description": "PG rent brackets (multi-select, INR per bed).",
"type": "array",
"items": {
"type": "string",
"enum": [
"under_6k",
"6_9k",
"9_12k",
"12_16k",
"16_20k",
"20k_plus"
]
}
},
"meals_included": {
"description": "PG meals included in rent.",
"type": "boolean"
},
"meals": {
"description": "PG meal slots required when meals are included.",
"type": "array",
"items": {
"type": "string",
"enum": [
"breakfast",
"lunch",
"dinner"
]
}
},
"suits": {
"description": "PG suits: working professionals or students.",
"type": "string",
"enum": [
"professional",
"student"
]
},
"amenities": {
"description": "PG property amenities (all required must be present on the listing).",
"type": "array",
"items": {
"type": "string",
"enum": [
"wifi",
"housekeeping",
"laundry",
"power_backup",
"parking",
"gym"
]
}
}
},
"required": [
"consent",
"email",
"city"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}