Raw schema
{
"type": "object",
"properties": {
"listing_type": {
"type": "string",
"enum": [
"sale",
"rent"
]
},
"property_type": {
"type": "string",
"enum": [
"apartment",
"house",
"land",
"commercial"
]
},
"price_amount": {
"type": "number",
"description": "Price (positive number)"
},
"price_currency": {
"type": "string",
"enum": [
"USD",
"PYG",
"BRL",
"ARS",
"UYU"
],
"description": "Use the currency local to the market (e.g. PYG in Paraguay, UYU or USD in Uruguay, ARS in Argentina, BRL in Brazil). Defaults to PYG if omitted."
},
"source_language": {
"type": "string",
"enum": [
"es",
"en",
"pt"
],
"description": "Language the title/description are written in"
},
"description": {
"type": "string"
},
"location": {
"type": "object",
"description": "Listing location. The country/market is inferred from the city and coordinates — use real place names so it resolves correctly (e.g. Asunción → Paraguay, Montevideo → Uruguay, Buenos Aires → Argentina, Curitiba → Brazil). For a draft, a city or neighborhood is enough; the owner sets the exact pin on the web. Provide latitude/longitude ONLY if you have precise coordinates — never guess them.",
"properties": {
"city": {
"type": "string",
"description": "City name, e.g. \"Asunción\", \"Montevideo\", \"Curitiba\""
},
"neighborhood": {
"type": "string",
"description": "Neighborhood name, e.g. \"Villa Morra\", \"Pocitos\""
},
"state_province": {
"type": "string",
"description": "State / province / department, e.g. \"Central\", \"Maldonado\", \"Buenos Aires\", \"Paraná\""
},
"address": {
"type": "string",
"description": "Street address if known (min 5 chars)"
},
"latitude": {
"type": "number",
"description": "Precise latitude. Omit if unknown."
},
"longitude": {
"type": "number",
"description": "Precise longitude. Omit if unknown."
}
}
},
"images": {
"type": "array",
"items": {
"type": "string",
"description": "Image URL (use upload_listing_image to get hosted URLs)"
},
"description": "Up to 25 image URLs. Optional for a draft; at least one is required to publish."
},
"apartment_details": {
"type": "object",
"description": "Bedrooms/bathrooms/area for the property.",
"properties": {
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"area_sqm": {
"type": "number",
"description": "Built / land area in square meters"
}
}
},
"house_details": {
"type": "object",
"description": "Bedrooms/bathrooms/area for the property.",
"properties": {
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"area_sqm": {
"type": "number",
"description": "Built / land area in square meters"
}
}
},
"land_details": {
"type": "object",
"description": "Bedrooms/bathrooms/area for the property.",
"properties": {
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"area_sqm": {
"type": "number",
"description": "Built / land area in square meters"
}
}
},
"commercial_details": {
"type": "object",
"description": "Bedrooms/bathrooms/area for the property.",
"properties": {
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"area_sqm": {
"type": "number",
"description": "Built / land area in square meters"
}
}
}
},
"required": [
"listing_type",
"property_type",
"price_amount",
"source_language",
"location"
]
}