Input schema (JSON)
{
"type": "object",
"title": "search_petsArguments",
"properties": {
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sex",
"default": null,
"description": "Sexo: 'male'/'macho' ou 'female'/'femea'."
},
"area": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Area",
"default": null,
"description": "Amplia a busca em volta de `city`: 'city'/'cidade' (padrão, só a cidade), 'neighbors'/'vizinhas' (mais as cidades que fazem divisa) ou 'radius'/'raio' (mais as cidades a até `radius_km` km). Resultados: a cidade primeiro, depois as vizinhas, depois o resto. Não combina com `name`."
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null,
"description": "Nome do MUNICÍPIO por extenso, não do bairro nem abreviado: 'Belo Horizonte', não 'BH'. Acento é opcional. Se o nome for ambíguo, ou se nenhuma ONG tiver pets ali hoje, o erro explica o que corrigir; isso não significa que a cidade não exista."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null,
"description": "Nome do pet como a pessoa escreveu ('nina', 'bebe'). Acentos e maiúsculas não importam; erros de grafia geralmente NÃO são encontrados. `name_match.confidence` diz quão certo é o pet encontrado. Se a lista vier vazia, o nome não foi encontrado como escrito."
},
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"description": "Página, começando em 1."
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size",
"default": null,
"description": "Porte: 'small'/'pequeno', 'medium'/'medio', 'large'/'grande'."
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Breed",
"default": null,
"description": "Raça: slug ('golden-retriever') ou nome em português ('pastor alemão'). A maioria do catálogo é SRD (sem raça definida)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"description": "Quantos resultados devolver por página. Valores acima de 24 são reduzidos a 24. Buscar por `name` devolve no máximo 5: é uma lista para confirmar, não para navegar."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), apenas para desambiguar `city`. Busca só por estado NÃO é suportada: sempre envie `city` junto."
},
"rescuer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Rescuer",
"default": null,
"description": "Restringe a busca a UMA ONG ou protetor: o código curto do link ou o @ do Instagram da ONG. Combina com os outros filtros ('gatos filhotes desta ONG'). Sem ele a busca cobre o catálogo inteiro."
},
"species": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Species",
"default": null,
"description": "Espécie: 'dog'/'cachorro' ou 'cat'/'gato'."
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Neutered",
"default": null,
"description": "true devolve somente pets castrados. `false` é IGNORADO pelo mesmo motivo de `vaccinated`; o valor de cada pet está em `neutered`."
},
"radius_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Radius Km",
"default": null,
"description": "Raio em km (1 a 100) para `area=radius`. Mandar só `radius_km` já significa raio."
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Vaccinated",
"default": null,
"description": "true devolve somente pets vacinados. `false` é IGNORADO: a maioria dos anúncios não informa vacinação, então filtrar por 'não vacinado' esconderia quase todo o catálogo. O valor de cada pet está em `vaccinated` (null = a ONG não informou)."
},
"include_older": {
"type": "boolean",
"title": "Include Older",
"default": false,
"description": "Sem efeito no momento: o catálogo devolve os pets anunciados em qualquer data, independente deste parâmetro. Mantido por compatibilidade. Um resultado pode ser antigo: `days_without_update`, quando vem, diz há quanto tempo."
},
"special_needs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Special Needs",
"default": null,
"description": "true devolve somente pets com cuidados especiais; false devolve somente os que não têm nenhum registrado."
},
"age_max_months": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Age Max Months",
"default": null,
"description": "Idade máxima em meses. O catálogo só distingue três faixas — filhote, adulto e idoso — então sem porte 6 e 12 selecionam os mesmos pets. Os cortes mudam com espécie e porte: idoso a partir de 8 anos no cão grande, 9 no médio, 10 no pequeno e no gato."
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Cats",
"default": null,
"description": "Somente pets que convivem bem com gatos."
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Dogs",
"default": null,
"description": "Somente pets que convivem bem com cães."
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Kids",
"default": null,
"description": "Somente pets que convivem bem com crianças."
},
"widen_if_empty": {
"type": "boolean",
"title": "Widen If Empty",
"default": false,
"description": "Se a área pedida não tiver pets disponíveis com os filtros, amplia a partir dela: cidades vizinhas, depois raio de 50 km, depois 100 km, parando no primeiro passo com pets. `searched_area` diz o que foi usado."
}
},
"additionalProperties": false
}