Random Pet & Animal Data API

Q: Can I generate only one species?

Yes — pass species (e.g. species=dog) and every record returns that species with a matching breed, realistic age and weight.

MOCK DATA

Coherent pet records for vet and pet-app fixtures — real breeds matched to species, realistic per-species ages and weights, names that follow sex.

Generated test data for fixtures and development

Base URL: /api/animals
Category: People
Capabilities: 1 route Seedable
Last updated: July 29, 2026

GET /api/animals Generate coherent pet records Returns a list

Live requestRuns against the public API

No key required

GET/api/animals?species=cat&count=5

Request parameters

species

Only generate this species — breed, age and weight all follow it. Omit for a mixed batch.

Advanced response options7 options

countdefault 10

How many records to generate (1–100).

seed

Deterministic output: the same seed always returns the same records. Omit for random (the used seed is echoed in meta.seed).

fields

Return only these fields (comma-separated). Mutually exclusive with 'exclude'.

exclude

Return all fields except these (comma-separated).

formatdefault json

Response format: json envelope, ndjson (one record per line) or csv.

prettydefault false

Pretty-print the JSON response.

unwrapdefault false

Drop the envelope: return the raw array/object without data/meta wrapper.

Response

Example parameters are ready. Send the request to inspect the live response.

Route reference

Code, request parameters, response fields and verified examples 8 params · 7 fields · 3 examples

Code samples Ready-to-copy requests in 4 languages

curl JavaScript Python PHP

curl "https://randomapi.dev/api/animals?species=cat&count=5"

const res = await fetch("https://randomapi.dev/api/animals?species=cat&count=5");
const { data, meta } = await res.json();

import requests

data = requests.get("https://randomapi.dev/api/animals?species=cat&count=5").json()["data"]

$json = json_decode(file_get_contents(
  "https://randomapi.dev/api/animals?species=cat&count=5"
), true);
$data = $json["data"];

Parameters Route-specific request inputs 1

Parameter	Type	Default & allowed	Description
`species`	enum	allowed: dog \| cat \| bird \| fish \| rabbit \| hamster \| reptile \| horse example: cat	Only generate this species — breed, age and weight all follow it. Omit for a mixed batch.

species enum

Only generate this species — breed, age and weight all follow it. Omit for a mixed batch.

example: species=cat

Universal parameters Shared response and formatting options 7

Parameter	Type	Default & allowed	Description
`count`	int	default: 10 allowed: 1 – 100 example: 3	How many records to generate (1–100).
`seed`	int	example: 42	Deterministic output: the same seed always returns the same records. Omit for random (the used seed is echoed in meta.seed).
`fields`	list	example: name,species	Return only these fields (comma-separated). Mutually exclusive with 'exclude'.
`exclude`	list	example: vaccinated	Return all fields except these (comma-separated).
`format`	enum	default: json allowed: json \| ndjson \| csv example: csv	Response format: json envelope, ndjson (one record per line) or csv.
`pretty`	boolean	default: false example: true	Pretty-print the JSON response.
`unwrap`	boolean	default: false example: true	Drop the envelope: return the raw array/object without data/meta wrapper.

count int

How many records to generate (1–100).

default: 10

allowed: 1 – 100

example: count=3

seed int

Deterministic output: the same seed always returns the same records. Omit for random (the used seed is echoed in meta.seed).

example: seed=42

fields list

Return only these fields (comma-separated). Mutually exclusive with 'exclude'.

example: fields=name,species

exclude list

Return all fields except these (comma-separated).

example: exclude=vaccinated

format enum

Response format: json envelope, ndjson (one record per line) or csv.

default: json

allowed: json | ndjson | csv

example: format=csv

pretty boolean

Pretty-print the JSON response.

default: false

example: pretty=true

unwrap boolean

Drop the envelope: return the raw array/object without data/meta wrapper.

default: false

example: unwrap=true

Response schema Fields returned in each record 7

Field	Type	Description	Example
`name`	string	Pet name, matched to the record's sex.	Luna
`species`	string	One of: dog, cat, bird, fish, rabbit, hamster, reptile, horse.	cat
`breed`	string	Real breed/type name drawn strictly from this species' pool.	Maine Coon
`sex`	string	male \| female.	female
`age`	integer	Age in whole years, from 0 (under a year) up to the species' documented maximum (e.g. hamster 3, dog 16, horse 30).	4
`weightKg`	float	Weight in kilograms, always inside the species' documented range (breed-independent).	4.6
`vaccinated`	boolean	True for ~80% of routine-vaccine species (dog, cat, rabbit, horse) and ~25% of the rest.	true

name string

Pet name, matched to the record's sex.

example: Luna

species string

One of: dog, cat, bird, fish, rabbit, hamster, reptile, horse.

example: cat

breed string

Real breed/type name drawn strictly from this species' pool.

example: Maine Coon

sex string

male | female.

example: female

age integer

Age in whole years, from 0 (under a year) up to the species' documented maximum (e.g. hamster 3, dog 16, horse 30).

example: 4

weightKg float

Weight in kilograms, always inside the species' documented range (breed-independent).

example: 4.6

vaccinated boolean

True for ~80% of routine-vaccine species (dog, cat, rabbit, horse) and ~25% of the rest.

example: true

Documented examples

Build-generated requests and complete responses 3

Five cats /api/animals?species=cat&count=5

GET /api/animals?species=cat&count=5

{
  "data": [
    {
      "name": "Gracie",
      "species": "cat",
      "breed": "Sphynx",
      "sex": "female",
      "age": 6,
      "weightKg": 5.4,
      "vaccinated": true
    },
    {
      "name": "Toby",
      "species": "cat",
      "breed": "Maine Coon",
      "sex": "male",
      "age": 11,
      "weightKg": 7.9,
      "vaccinated": true
    },
    {
      "name": "Oliver",
      "species": "cat",
      "breed": "Burmese",
      "sex": "male",
      "age": 9,
      "weightKg": 5.6,
      "vaccinated": true
    },
    {
      "name": "Luna",
      "species": "cat",
      "breed": "Bengal",
      "sex": "female",
      "age": 3,
      "weightKg": 7.8,
      "vaccinated": false
    },
    {
      "name": "Coco",
    …
    "generatedAt": "2026-07-29T08:13:22.000Z"
  }
}

Reproducible dog fixtures /api/animals?species=dog&seed=42&count=10

GET /api/animals?species=dog&seed=42&count=10

{
  "data": [
    {
      "name": "Gracie",
      "species": "dog",
      "breed": "Dachshund",
      "sex": "female",
      "age": 5,
      "weightKg": 33.2,
      "vaccinated": true
    },
    {
      "name": "Toby",
      "species": "dog",
      "breed": "Labrador Retriever",
      "sex": "male",
      "age": 8,
      "weightKg": 59.4,
      "vaccinated": true
    },
    {
      "name": "Oliver",
      "species": "dog",
      "breed": "Shih Tzu",
      "sex": "male",
      "age": 7,
      "weightKg": 35.2,
      "vaccinated": true
    },
    {
      "name": "Luna",
      "species": "dog",
      "breed": "Golden Retriever",
      "sex": "female",
      "age": 3,
      "weightKg": 57.5,
      "vaccinated": false
    },
    {
      "name": "Coco",
    …
    "generatedAt": "2026-07-29T08:13:22.000Z"
  }
}

Mixed shelter intake, names and breeds only /api/animals?count=20&seed=7&fields=name,species,breed

GET /api/animals?count=20&seed=7&fields=name,species,breed

{
  "data": [
    {
      "name": "Sadie",
      "species": "hamster",
      "breed": "Chinese"
    },
    {
      "name": "Ziggy",
      "species": "rabbit",
      "breed": "Mini Lop"
    },
    {
      "name": "Hazel",
      "species": "fish",
      "breed": "Zebra Danio"
    },
    {
      "name": "Daisy",
      "species": "reptile",
      "breed": "Ball Python"
    },
    {
      "name": "Rocky",
      "species": "horse",
      "breed": "Morgan"
    },
    {
      "name": "Hank",
      "species": "hamster",
      "breed": "Chinese"
    },
    {
      "name": "Hank",
      "species": "horse",
      "breed": "Friesian"
    },
    {
      "name": "Leo",
      "species": "reptile",
    …
    "generatedAt": "2026-07-29T08:13:22.000Z"
  }
}

About this API

Coverage, behavior and common use cases

Coverage & behavior

Generates internally-coherent pet records. The breed is drawn strictly from the record's own species' pool of real breed names — a cat gets Maine Coon or Siamese, never Beagle — and age and weightKg always stay inside realistic per-species ranges, so a hamster is never 12 years old and a horse never weighs 4 kg.

?species= genuinely constrains every record; omit it for a mixed batch where each record is still coherent with its own species. The exact ranges:

species	breeds in pool	age (years)	weight (kg)
dog	16	0–16	3–60
cat	14	0–20	2.5–8
bird	12	0–30	0.02–1.2
fish	12	0–10	0.001–2
rabbit	12	0–12	1–7
hamster	5	0–3	0.02–0.05
reptile	12	0–30	0.05–6
horse	14	0–30	300–700

name follows sex (separate male/female name pools), and vaccinated mirrors real-world practice: true for roughly 80% of species with routine vaccine protocols (dog, cat, rabbit, horse) and roughly 25% of the rest. Weight is species-coherent but deliberately breed-independent — a Chihuahua record may weigh like a Great Dane. Everything is mock data; only the breed names themselves are real. With a seed, the same request reproduces byte-for-byte.

Use it for

Seed a veterinary clinic or pet-adoption demo database with species-coherent patients
Test pet-insurance or booking forms with realistic species/breed/age/weight combinations
Stable shelter-roster fixtures via seed — the same animals in every CI run

Frequently asked questions

Practical answers about this endpoint 3

Are the breeds real?

Yes — breed names are real breeds matched to their species (a Labrador never shows up as a cat), while the individual animals are generated.

Can I generate only one species?

Yes — pass species (e.g. species=dog) and every record returns that species with a matching breed, realistic age and weight.

Why do ages and weights differ per species?

Each species has its own realistic age and weight range, so a hamster never weighs 30 kg — that keeps fixtures believable for vet and pet-app demos.

Useful next tools in the catalog

Random User Data API MOCK DATA

Complete fake people — name, age-consistent birth date, email, phone, job and address — with working filters for gender, age range and email domain.

Random Name Generator API MOCK DATA

Random person names — first, last and full — with a strict gender filter, locale-aware name pools in 8 languages and seed-reproducible output.

Random Food & Dish API MOCK DATA

Fake dishes from 12 cuisines with coherent ingredient lists, calories and spice levels — a real vegetarian filter that bans every meat ingredient.