Adoptapet APIadoptapet.com ↗
Search adoptable and foster pets by zip code, retrieve detailed pet profiles with photos, and find animal shelters by location via the Adoptapet.com API.
What is the Adoptapet API?
The Adoptapet.com API exposes 4 endpoints covering pet adoption search, foster listings, individual pet profiles, and shelter lookup. Use search_pets to find dogs and cats available for adoption near any US zip code, or get_pet_profile to pull a specific animal's breed, age, photos, story text, and shelter details from its listing page.
curl -X GET 'https://api.parse.bot/scraper/62c001ed-763d-4077-bc26-3ae13e90dd6c/search_pets?page=1&radius=25&species_id=1&foster_only=false&postal_code=90210' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace adoptapet-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Adopt-a-Pet SDK — find adoptable pets, view profiles, locate shelters."""
from parse_apis.adopt_a_pet_api import AdoptAPet, Species, NotFoundError_
client = AdoptAPet()
# Search for adoptable dogs near Beverly Hills, limit to 5 results
for pet in client.petsummaries.search(postal_code="90210", species=Species.DOG, limit=5):
print(pet.name, pet.summary)
# Drill into the first result's full profile via sub-resource
pet = client.petsummaries.search(postal_code="90210", species=Species.CAT, limit=1).first()
if pet:
profile = pet.profile.get()
print(profile.name, profile.attributes.breed, profile.is_foster_likely)
for photo in profile.photos[:2]:
print(photo)
# Search for foster-only pets
foster_pet = client.petsummaries.search_foster(postal_code="10001", species=Species.DOG, limit=1).first()
if foster_pet:
print(foster_pet.name, foster_pet.url)
# Find shelters by location
try:
for shelter in client.shelters.find(location="Los Angeles, CA", limit=3):
print(shelter.name, shelter.address, shelter.phone)
except NotFoundError_ as exc:
print(f"Location not found: {exc}")
print("exercised: petsummaries.search / petsummaries.search_foster / profile.get / shelters.find")
Search for animals available for adoption or foster care near a given postal code. Returns paginated results with basic pet info including name, breed summary, and profile URL. Pagination advances by integer page number. Each result carries a pet_url suitable for get_pet_profile drill-down.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| radius | integer | Search radius in miles |
| species_id | string | Species ID: '1' for Dog, '2' for Cat |
| foster_only | boolean | If true, only show foster animals |
| postal_coderequired | string | US postal/zip code to search near (e.g. '90210') |
{
"type": "object",
"fields": {
"page": "integer current page number",
"pets": "array of pet objects each with pet_id, name, url, and summary",
"postal_code": "string postal code used for the search",
"total_on_page": "integer count of pets returned on this page"
},
"sample": {
"data": {
"page": 1,
"pets": [
{
"url": "https://www.adoptapet.com/pet/47034772-beverly-hills-siberian-husky-mix",
"name": "Riley",
"pet_id": "47034772",
"summary": "Riley Siberian Husky German Shepherd Dog Male, 4 yrs 2 mos Beverly Hills, CA"
}
],
"postal_code": "90210",
"total_on_page": 42
},
"status": "success"
}
}About the Adoptapet API
Pet Search and Foster Listings
search_pets accepts a required postal_code and optional parameters including radius (miles), species_id ('1' for dogs, '2' for cats), and a foster_only boolean flag. Results are paginated via the page parameter and return an array of pet objects, each containing a pet_id, name, url, and a summary string. search_foster_pets is a dedicated shortcut for the same query with foster filtering pre-applied, accepting the same location and species inputs without a separate toggle.
Detailed Pet Profiles
get_pet_profile takes a full profile URL — typically sourced from the url field in search results — and returns structured pet data including name, story (the free-text description written by the shelter), an array of photos URLs, an attributes object covering breed, age, sex, color, size, weight, and pet_id, and a shelter object with the caring organization's name and profile URL. A is_foster_likely boolean indicates whether the animal appears to be in foster care rather than at a shelter facility.
Shelter Discovery
find_shelter searches for shelters and rescue organizations by location, accepting input in 'City, ST' format (e.g., 'Austin, TX') or a full state name (e.g., 'Texas'). Each shelter in the results array includes name, url, address, and phone, plus a total count of matching organizations found.
The Adoptapet API is a managed, monitored endpoint for adoptapet.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when adoptapet.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official adoptapet.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a pet adoption locator app that surfaces dogs and cats near a user's zip code using
search_petsresults. - Aggregate foster-only listings across multiple zip codes by calling
search_foster_petswith varyingpostal_codevalues. - Populate a pet detail page with breed, age, photos, and story text pulled from
get_pet_profile. - Map animal shelters across a state by iterating
find_shelterwith city/state inputs and plotting returnedaddressfields. - Send adoption alerts when new pets matching a species or location appear in paginated
search_petsresults. - Display shelter contact info (name, phone, URL) alongside a pet's profile by combining
get_pet_profileshelter data withfind_shelterresults. - Filter a local pet directory to foster-only animals using the
is_foster_likelyfield fromget_pet_profile.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Adoptapet.com have an official developer API?+
What does `get_pet_profile` return beyond the search summary?+
get_pet_profile returns the pet's full story text, an array of photo URLs, a structured attributes object with fields like breed, age, sex, color, size, and weight, the caring shelter's name and URL, and an is_foster_likely flag. Search endpoints return only pet_id, name, url, and a brief summary.Is the search limited to the US?+
search_pets and search_foster_pets require a US postal code, and find_shelter expects a US city/state or state name. Non-US locations are not covered. You can fork this API on Parse and revise it to add support for Canadian postal codes or other regional formats if Adoptapet.com's listings include them.Does the API return contact information for individual pet owners or private rehomers?+
shelter object in get_pet_profile and the find_shelter endpoint, but private individual rehoming listings are not exposed. You can fork it on Parse and revise it to add an endpoint targeting that listing type.Can I filter search results by breed or age directly in `search_pets`?+
search_pets filters by postal_code, radius, species_id, and foster_only. Breed and age data are only available after fetching a specific pet's profile via get_pet_profile. You can fork this API on Parse and revise it to add breed or age filter parameters if that data becomes accessible through the search layer.