Pawlisty Pet Listings

Search live pet listings for sale or adoption on Pawlisty. Use whenever a user wants to buy or adopt a pet or asks what is available, filtered by species, breed, location, price, or care attributes. Returns current listings with links to pawlisty.com.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text keywords."
    },
    "species": {
      "type": "string",
      "enum": [
        "dogs",
        "cats",
        "birds",
        "fish-aquariums",
        "reptiles-amphibians",
        "small-animals",
        "farm-animals",
        "horses"
      ]
    },
    "breed": {
      "type": "string",
      "description": "Breed name; resolved to a breed id. Use browse_breeds to disambiguate."
    },
    "listing_type": {
      "type": "string",
      "enum": [
        "for_sale",
        "lost",
        "found"
      ],
      "default": "for_sale"
    },
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 (e.g. US, GB). Defaults to the site default."
    },
    "location": {
      "type": "string",
      "description": "City, or a state/region name or code (e.g. \"Livermore\", \"California\", \"CA\"). A state searches the whole state; \"City, ST\" searches the city and falls back to the state."
    },
    "city_id": {
      "type": "integer",
      "description": "Exact city id if known."
    },
    "distance_km": {
      "type": "integer",
      "minimum": 0,
      "maximum": 500,
      "default": 50
    },
    "price_min": {
      "type": "number"
    },
    "price_max": {
      "type": "number"
    },
    "gender": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ]
    },
    "age": {
      "type": "string",
      "enum": [
        "newborn",
        "young",
        "adolescent",
        "adult",
        "senior"
      ],
      "description": "newborn 0-8wk, young 2-6mo, adolescent 6-12mo, adult 1-7yr, senior 7+yr."
    },
    "vaccinated": {
      "type": "string",
      "enum": [
        "yes",
        "no",
        "partially"
      ]
    },
    "desexed": {
      "type": "string",
      "enum": [
        "yes",
        "no"
      ],
      "description": "Neutered or spayed."
    },
    "size": {
      "type": "string",
      "enum": [
        "small",
        "medium",
        "large",
        "extra_large"
      ]
    },
    "good_with": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "dogs",
          "cats",
          "children"
        ]
      }
    },
    "verified_only": {
      "type": "boolean",
      "default": false,
      "description": "Only photo-verified listings."
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "date",
        "priceAsc",
        "priceDesc",
        "distance"
      ],
      "default": "relevance"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  }
}

Get full details for one Pawlisty listing by id. Use after search_pet_listings when the user wants more on a specific pet. To contact the seller the user must visit the listing page.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Listing id."
    }
  },
  "required": [
    "id"
  ]
}

Return Pawlisty buyer-safety guidance (avoiding pet scams, FAQ on buying/adopting safely). Use for any "how do I safely buy or adopt a pet" or "is this listing a scam" question. Returns a summary and a link to the full guide on pawlisty.com.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "avoiding_scams",
        "faq"
      ],
      "description": "Which guide. Omit to return all buyer guides."
    }
  }
}

List pet breeds Pawlisty covers, with links to breed guides and current availability. Use when comparing breeds or researching before buying. Returns a breed id usable in search_pet_listings.

{
  "type": "object",
  "properties": {
    "species": {
      "type": "string",
      "enum": [
        "dog",
        "cat",
        "bird",
        "reptile",
        "fish",
        "small_animal"
      ]
    },
    "query": {
      "type": "string",
      "description": "Breed name fragment."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 25
    }
  }
}