{"openapi":"3.1.0","info":{"title":"Cat Facts & Breeds API","version":"1.0.0","description":"Cat trivia and breed data via the open Cat Fact API (catfact.ninja) — no key. The fact endpoint returns a single random cat fact, optionally bounded to a maximum length; the facts endpoint pages through the full fact collection; and the breeds endpoint lists and searches cat breeds with their country, origin, coat and pattern. Real data, with the breed list cached for speed — no key. 4 endpoints. Ideal for pet apps, fun facts widgets, daily-fact bots, quizzes and onboarding delight.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/catfact-api","description":"oanor gateway"}],"tags":[{"name":"Cats"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/breeds":{"get":{"operationId":"get_v1_breeds","tags":["Cats"],"summary":"Cat breeds","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Search breed, country, origin or coat","schema":{"type":"string"},"example":"siamese"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 25)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"total":1,"breeds":[{"coat":"Short","breed":"Siamese","origin":"Natural","country":"Thailand","pattern":"Colorpoint"}]},"meta":{"timestamp":"2026-06-08T09:48:46.859Z","request_id":"f1b85c41-9bef-48a0-927d-8f121b91c23f"},"status":"ok","message":"Breeds retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/fact":{"get":{"operationId":"get_v1_fact","tags":["Cats"],"summary":"A random cat fact","description":"","parameters":[{"name":"max_length","in":"query","required":false,"description":"Max length of the fact","schema":{"type":"string"},"example":"60"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fact":"Neutering a cat extends its life span by two or three years.","length":60},"meta":{"timestamp":"2026-06-08T09:48:47.153Z","request_id":"f53bdea4-d7f3-49ef-904e-375e7bdbae55"},"status":"ok","message":"Fact retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/facts":{"get":{"operationId":"get_v1_facts","tags":["Cats"],"summary":"Page through facts","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Per page (1-100, default 10)","schema":{"type":"string"},"example":"10"},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"string"},"example":"1"},{"name":"max_length","in":"query","required":false,"description":"Max length","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":10,"facts":[{"fact":"Unlike dogs, cats do not have a sweet tooth. Scientists believe this is due to a mutation in a key taste receptor.","length":114},{"fact":"When a cat chases its prey, it keeps its head level. Dogs and humans bob their heads up and down.","length":97},{"fact":"The technical term for a cat’s hairball is a “bezoar.”","length":54},{"fact":"A group of cats is called a “clowder.”","length":38},{"fact":"A cat can’t climb head first down a tree because every claw on a cat’s paw points the same way. To get down from a tree, a cat must back down.","length":142},{"fact":"Cats make about 100 different sounds. Dogs make only about 10.","length":62},{"fact":"Every year, nearly four million cats are eaten in Asia.","length":55},{"fact":"There are more than 500 million domestic cats in the world, with approximately 40 recognized breeds.","length":100},{"fact":"Approximately 24 cat skins can make a coat.","length":43},{"fact":"While it is commonly thought that the ancient Egyptians were the first to domesticate cats, the oldest known pet cat was recently found in a 9,500-year-old grave on the Mediterranean island of Cyprus. This grave predates early Egyptian art depicting cats by 4,000 years or more.","length":278}],"total":332,"per_page":10},"meta":{"timestamp":"2026-06-08T09:48:47.415Z","request_id":"16aebfef-c5fe-44c0-847d-c0268b474678"},"status":"ok","message":"Facts retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"catfact-api","endpoints":{"GET /v1/fact":"A single random cat fact (max_length=optional).","GET /v1/meta":"This document.","GET /v1/facts":"Page through the fact collection (limit=, page=, max_length=).","GET /v1/breeds":"Cat breeds with country, origin, coat & pattern (q=search, limit=)."},"description":"Cat trivia and breed data via the open Cat Fact API (catfact.ninja): pull a single random cat fact (optionally length-bounded), page through the full fact collection, or list and search cat breeds with their country, origin, coat and pattern. Real data, no key."},"meta":{"timestamp":"2026-06-08T09:48:47.503Z","request_id":"eb18e02c-5ce4-43c1-aa6c-6de5854f6f13"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6800,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":600,"monthly_call_quota":91500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":554500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6900,"monthly_call_quota":2710000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/catfact-api"}