Pets4homes APIpets4homes.co.uk ↗
Search and browse available dogs for sale across the UK's largest pet classifieds marketplace, filtering by breed, location, price, and other criteria to find your ideal pet. View detailed listings with photos, descriptions, and seller information to compare dogs and make informed adoption decisions.
curl -X GET 'https://api.parse.bot/scraper/a54db699-cc6c-4222-8ca5-febea5aec36e/search_dogs?page=1&keyword=labrador&max_price=2000&min_price=100' \ -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 pets4homes-co-uk-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: Pets4Homes SDK — search dogs for sale, drill into listing details."""
from parse_apis.pets4homes_co_uk_api import Pets4Homes, ListingNotFound
client = Pets4Homes()
# Search for labrador puppies, cap at 5 results
for listing in client.listing_summaries.search(keyword="labrador", limit=5):
print(listing.title, listing.breed, listing.price_amount)
# Drill down: get one listing summary, then fetch full details
summary = client.listing_summaries.search(keyword="cockapoo", max_price="1000", limit=1).first()
if summary:
detail = summary.details()
print(detail.title, detail.location.town, detail.seller.profile_name)
for pet in detail.pets_in_litter:
print(pet.name, pet.gender, pet.status, pet.price_amount)
# Direct get by slug via the listings collection
full = client.listings.get(slug="cnzviixpd-6-adorable-labrador-retriever-puppies-maldon")
print(full.description[:100], full.views_count)
# Typed error handling: catch a not-found listing
try:
client.listings.get(slug="nonexistent-listing-slug")
except ListingNotFound as exc:
print(f"Listing not found: {exc}")
print("exercised: listing_summaries.search / summary.details / listings.get / ListingNotFound")
Search for dogs/puppies for sale on Pets4Homes. Returns paginated results with breed, price, location, and seller details. Results are sorted by newest first. Keyword search matches breed names, descriptions, and titles. Price filters narrow results by listing price range.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| keyword | string | Search keyword to filter listings (matches breed, title, description). Examples: 'labrador', 'cockapoo', 'small white'. |
| max_price | string | Maximum price in GBP to filter listings (e.g. '500', '1000'). |
| min_price | string | Minimum price in GBP to filter listings (e.g. '200', '500'). |
{
"type": "object",
"fields": {
"listings": "array of dog listing summaries with id, title, slug, price, breed, location, and seller info",
"total_items": "integer",
"total_pages": "integer",
"current_page": "integer"
},
"sample": {
"data": {
"listings": [
{
"id": "2fd400d9-b8ba-44dd-8f84-95974ed83d66",
"slug": "cnzviixpd-6-adorable-labrador-retriever-puppies-maldon",
"breed": "Labrador Retriever",
"title": "6 adorable Labrador retriever puppies",
"status": "Active",
"seller_id": "453425f1-d949-4217-a8a8-7bbef8739252",
"breed_code": "pets.dogs.breed.labradorRetriever",
"is_boosted": true,
"images_count": 20,
"price_amount": 1200,
"published_at": "2026-06-23T23:20:56.417Z",
"videos_count": 0,
"location_town": "Maldon",
"price_currency": "GBP",
"listing_package": "Basic",
"location_region": "Essex",
"description_preview": "6 beautiful cream Labrador puppies looking for their forever homes.",
"location_country_region": "England"
}
],
"total_items": 864,
"total_pages": 36,
"current_page": 1
},
"status": "success"
}
}About the Pets4homes API
The Pets4homes API on Parse exposes 2 endpoints for the publicly available data on pets4homes.co.uk. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.