Search by description
search_by_descriptionRead-onlyIdempotent
Find pets to adopt from a sentence in any language (found pets, marked found:true, are not adoptable yet): “a calm small dog that is good with kids, under 10 kg, near Springfield”. Returns the pets AND what was understood (understood.chips: species, breed, age, size, good-with, place, radius...), so you can tell the person what was searched and drop a wrong one with off=[chip id]. Good-with and similar facts are only filters when a listing states them; each pet has match[] saying stated / not_stated. Weight caps are approximated by size group and energy is only a hint. If the AI parts are unavailable it still answers from the words (degraded says so). Prefer find_pets when you already have structured values.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| off | No | Chip ids from a previous answer's understood.chips to leave out, e.g. ["good_with:kids"] | |
| lang | No | The person's language: en, es, zh-Hant, zh-Hans, ko, ja, vi, fr, ar, tl (default en) | |
| near | No | A US ZIP, lat,lon or a Taiwan place, if it is not in the query | |
| page | No | ||
| limit | No | ||
| query | Yes | What the person wants, in their own words and language, e.g. “a calm small dog good with kids, under 10 kg, near 65738” | |
| country | No | ||
| include_unknown | No | Also include pets whose listing does not say whether they are good with dogs/cats/kids (they are marked not_stated) |