dogs4homes.co.uk APIdogs4homes.co.uk ↗
Search and retrieve dog adoption listings from Pets4Homes. Filter by breed, size, and child compatibility. Get full profiles with images, location, and seller info.
curl -X GET 'https://api.parse.bot/scraper/a05e0422-8811-4336-a508-33925ec23b46/search_dogs?page=1&query=dog' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for dogs available for adoption on Pets4Homes with optional keyword, breed, size, and children-compatibility filters. Returns paginated results sorted by date published.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| size | string | Desired dog size keyword (e.g. 'small', 'medium', 'large'). Filters by keyword match in the listing description. |
| breed | string | Breed slug to filter by (e.g. 'akita', 'labrador', 'mixed-breed'). Maps to the site's breed category URL segment. |
| query | string | Search keyword to filter listings. |
| children_compatible | boolean | If true, filters results for dogs whose description mentions children/child compatibility. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"listings": "array of listing objects with id, title, slug, price, currency, location, breed, published_at, description_preview, image",
"total_pages": "integer total number of pages available",
"total_results": "integer total number of matching listings"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"id": "dd8e5e1e-e13e-4089-9ef4-260a6e2ff008",
"slug": "4xkaqrtxh-milady-perfect-in-every-way2-yo-upper-medium-norwich",
"breed": "pets.dogs.breed.mixedBreed",
"image": "https://assets.pets4homes.co.uk/originalImages/29760a65-3867-490a-9540-88908832a9e8/100/##NAME##.jpeg",
"price": 450,
"title": "MILADY PERFECT IN EVERY WAY 2 yo upper-medium",
"currency": "GBP",
"location": "Norwich, England",
"published_at": "2026-05-06T01:33:32.926Z",
"description_preview": "MILADY - PERFECT IN EVERY WAY... EXCEPT ONE - NO CATS. UK BASED - LOOKING FOR URGENT FOSTER OR FOSTER-TO-ADOPT."
}
],
"total_pages": 30,
"total_results": 709
},
"status": "success"
}
}About the dogs4homes.co.uk API
The Pets4Homes API exposes 2 endpoints for searching and retrieving dog adoption listings from dogs4homes.co.uk (Pets4Homes). The search_dogs endpoint returns paginated results with up to 8 fields per listing—including breed, price, location, and a description preview—while get_dog_details delivers a full profile with images, seller information, neutered status, and a view count for any individual listing identified by its slug.
Search Endpoint
The search_dogs endpoint accepts up to five optional parameters: query for keyword filtering, breed for breed-slug filtering (e.g. labrador, akita, mixed-breed), size for keyword-based size filtering (small, medium, large), children_compatible to surface dogs explicitly noted as child-friendly, and page for pagination. Each response includes total_results, total_pages, and a listings array. Each listing object carries id, title, slug, price, currency, location, breed, published_at, description_preview, and image.
Listing Detail Endpoint
The get_dog_details endpoint takes a single required slug parameter—available from search_dogs results—and returns the full listing record. Response fields include a UUID id, an attributes object covering breed, health status, neutered status, and relevant dates, an images array of URLs, a location object with town, region, and postcode, a user object with seller name, type, and charity flag, plus views, price, currency, title, and created_at timestamp.
Data Scope and Freshness
Listings reflect the public-facing state of Pets4Homes at query time. The breed parameter maps to the site's category URL segments, so values like golden-retriever or french-bulldog must match the site's slug conventions. The size filter operates on keyword matching within listing descriptions rather than a structured attribute, so results may vary by how individual sellers phrase their listings.
Pagination
The search_dogs endpoint returns total_pages and total_results alongside the current page number, allowing full result-set traversal by incrementing the page parameter across requests.
- Build a dog adoption aggregator filtered by breed slug and geographic region from the
locationfield. - Monitor new listings by polling
search_dogssorted bypublished_atand alerting on new entries. - Filter listings for families by combining the
children_compatibleflag with abreedfilter. - Enrich a pet charity database with seller
user.typeanduser.charityfields fromget_dog_details. - Track listing popularity over time using the
viewscount returned byget_dog_details. - Power a breed-specific adoption digest by iterating
search_dogswith different breed slugs and extractingdescription_previewandimagefields.
| 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 Pets4Homes have an official developer API?+
What does the `attributes` object in `get_dog_details` contain?+
attributes object is a key-value map that can include breed, health status, neutered status, and relevant dates associated with the listing. The exact keys present depend on what the seller filled in for that specific listing, so not all keys appear in every response.Does the `size` filter work the same as the `breed` filter?+
breed parameter maps to a structured breed category, while size works by matching the supplied keyword against listing descriptions. This means a listing for a 'small Labrador' might not appear in a size=small search if the seller didn't use that phrasing, so results may be incomplete compared to breed filtering.Can I retrieve cat or small animal listings from Pets4Homes through this API?+
search_dogs and get_dog_details. You can fork it on Parse and revise it to add endpoints targeting other animal categories on the site.Is seller contact information like phone number or email returned?+
user object in get_dog_details returns seller name, type, and charity status, but direct contact details such as phone numbers or email addresses are not exposed. You can fork it on Parse and revise it to add any additional seller fields if they become available in the listing data.