adoptapet.com 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.
curl -X GET 'https://api.parse.bot/scraper/62c001ed-763d-4077-bc26-3ae13e90dd6c/search_pets?page=1&radius=50&species_id=1&postal_code=90210' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| 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 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 1 mo Beverly Hills, CA"
}
],
"postal_code": "90210",
"total_on_page": 42
},
"status": "success"
}
}About the adoptapet.com 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.
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.
- 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 | 250 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.