rescuegroups.org APIrescuegroups.org ↗
Search adoptable animals from rescue organizations by breed, location, and sex. Get detailed profiles with photos and org contact info via the RescueGroups API.
curl -X GET 'https://api.parse.bot/scraper/40e2c4c3-549a-4b4d-8f04-af8360e25a88/search_available_animals?page=1&distance=25&location=10128' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for available/adoptable animals with filters for breed, sex, location, and distance. Can filter for animals needing foster care. Returns paginated results.
| Param | Type | Description |
|---|---|---|
| sex | string | Sex of the animal: Male, Female, or omit for either. |
| page | integer | Page number of results. |
| breed | string | Breed ID to filter by (use get_breeds endpoint to retrieve valid IDs). |
| distance | integer | Search radius in miles from the specified location. |
| location | string | ZIP/Postal code to search near. |
| needs_foster | boolean | When true, filters for animals needing foster homes only. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"animals": "array of animal summary objects with id, name, breed, basic_info, distance, and photo_url",
"summary": "string describing total number of pets found"
},
"sample": {
"data": {
"page": 1,
"animals": [
{
"id": "22214132",
"name": "Ravioli SA Petite Pirate",
"breed": "Domestic Medium Hair / Mixed (medium coat)",
"distance": "",
"photo_url": "https://cdn.rescuegroups.org/1861/pictures/animals/22214/22214132/102558999.jpg",
"basic_info": "Young Female"
}
],
"summary": "760 pets found"
},
"status": "success"
}
}About the rescuegroups.org API
The RescueGroups API covers 3 endpoints that expose adoptable animal listings, detailed animal profiles, and a full breed reference list from RescueGroups.org. Use search_available_animals to query pets by breed ID, ZIP code, distance radius, sex, or foster-need status, then call get_animal_details to retrieve the full profile including photos, age category, qualities, and the rescue organization's contact information.
Search and Filter Adoptable Animals
search_available_animals accepts up to six filter parameters: breed (a breed ID from the get_breeds endpoint), sex (Male or Female), location (ZIP or postal code), distance (miles radius), needs_foster (boolean to surface foster-only listings), and page for pagination. Results return an array of animal summary objects, each with id, name, breed, basic_info, distance, and photo_url, plus a summary string reporting total match count.
Animal Detail Profiles
get_animal_details takes a single required animal_id — the numeric identifier from search results — and returns the full record. Response fields include age (categorical: Baby, Young, Adult, Senior), sex, breed, status, location, qualities (an array of attribute strings such as house-trained or good with kids), a photos array of URL strings, and an organization object containing the rescue's name, email, and url.
Breed Reference
get_breeds requires no inputs and returns the complete list of breed objects used across the platform. Each entry contains an id string and a name string. Pass the id value directly into the breed parameter of search_available_animals to filter results by a specific breed. This lookup is stable enough to cache between sessions rather than fetching on every search.
- Build a pet adoption finder that filters available animals by breed and ZIP code proximity
- Surface foster-needed animals specifically by setting needs_foster to true in search queries
- Display full adoption profiles with photo galleries by chaining search results into get_animal_details
- Show rescue organization contact details (email and URL) alongside each animal listing
- Power a breed-selector UI by pre-loading the get_breeds reference list
- Aggregate adoptable pet data by location for shelter capacity or intake trend analysis
- Send targeted alerts when new animals matching saved breed and location criteria appear
| 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.