# AKC API > AKC workflow and API: dog breed. Returns energy, height, weight and barking as JSON. AKC data from akc.org: dog breed. - Page: https://fous.com/workflows/akc - Handle: `@akc` - Category: [Other](https://fous.com/workflows/category/other) - Source website: https://akc.org - Last verified: Sep 29, 2026 - Fous is not affiliated with AKC. ## Methods ### Get dog breed Operation `get_dog_breed`, version 1. 1 credit per call. Get an AKC dog breed profile by name or common nickname, with measurements, temperament, trait ratings, photo, and profile link. Measurements may omit a lower or upper bound when AKC lists only one. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `breed` | string | yes | `"Golden Retriever"` | Name or common nickname of a dog breed, for example Golden Retriever or Frenchie. | **Input schema** ```json { "type": "object", "required": [ "breed" ], "properties": { "breed": { "type": "string", "description": "Name or common nickname of a dog breed, for example Golden Retriever or Frenchie.", "examples": [ "Golden Retriever", "Frenchie", "Doxie" ] } }, "additionalProperties": false, "examples": [ { "breed": "Golden Retriever" }, { "breed": "Frenchie" }, { "breed": "Doxie" } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `energy` | integer or null | `3` | AKC energy rating from 1 to 5. | | `height` | string or null | `"23-24 inches (male), 21.5-22.5 inches (female)"` | AKC height as shown, including male and female figures. | | `weight` | string or null | `"65-75 pounds (male), 55-65 pounds (female)"` | AKC weight as shown, including male and female figures. | | `barking` | integer or null | `1` | AKC barking rating from 1 to 5. | | `akc_link` | string or null | `"https://www.akc.org/dog-breeds/golden-retriever/"` | AKC breed profile link. | | `drooling` | integer or null | `2` | AKC drooling rating from 1 to 5. | | `grooming` | integer or null | `2` | AKC grooming rating from 1 to 5. | | `shedding` | integer or null | `4` | AKC shedding rating from 1 to 5. | | `breed_name` | string or null | `"Golden Retriever"` | Breed name. | | `breed_group` | string or null | `"Sporting Group"` | Breed group. | | `description` | string or null | `"The Golden Retriever, an exuberant Scottish gundog of great beauty, stands among America's most popular dog breeds. The` | Description. | | `temperament` | string or null | `"intelligent / friendly / devoted"` | Temperament. | | `trainability` | integer or null | `5` | AKC trainability rating from 1 to 5. | | `life_expectancy` | string or null | `"10-12 years"` | Life expectancy. | | `photo_image_link` | string or null | `"https://www.akc.org/wp-content/uploads/2017/11/Golden-Retriever-wading-into-a-lake.jpg"` | Link to the breed photo on AKC. | | `height_max_inches` | number or null | `24` | Height max inches across AKC height or weight figures. | | `height_min_inches` | number or null | `21.5` | Height min inches across AKC height or weight figures. | | `weight_max_pounds` | number or null | `75` | Weight max pounds across AKC height or weight figures. | | `weight_min_pounds` | number or null | `55` | Weight min pounds across AKC height or weight figures. | | `good_with_other_dogs` | integer or null | `5` | AKC good with other dogs rating from 1 to 5. | | `affectionate_with_family` | integer or null | `5` | AKC affectionate with family rating from 1 to 5. | | `good_with_young_children` | integer or null | `5` | AKC good with young children rating from 1 to 5. | **Example input** ```json { "breed": "Golden Retriever" } ``` **Example output** ```json { "energy": 3, "height": "23-24 inches (male), 21.5-22.5 inches (female)", "weight": "65-75 pounds (male), 55-65 pounds (female)", "barking": 1, "akc_link": "https://www.akc.org/dog-breeds/golden-retriever/", "drooling": 2, "grooming": 2, "shedding": 4, "breed_name": "Golden Retriever", "breed_group": "Sporting Group", "description": "The Golden Retriever, an exuberant Scottish gundog of great beauty, stands among America's most popular dog breeds. They are serious workers at hunting and field work, as guides for the blind, and in …", "temperament": "intelligent / friendly / devoted", "trainability": 5, "life_expectancy": "10-12 years", "photo_image_link": "https://www.akc.org/wp-content/uploads/2017/11/Golden-Retriever-wading-into-a-lake.jpg", "height_max_inches": 24, "height_min_inches": 21.5, "weight_max_pounds": 75, "weight_min_pounds": 55, "good_with_other_dogs": 5, "affectionate_with_family": 5, "good_with_young_children": 5 } ``` ## Quick start Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys). ```bash # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' : "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}" curl 'https://api.fous.com/v1/query' \ --fail-with-body --silent --show-error --max-time 120 \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '{ "api": "@akc", "visibility": "public", "operation": "get_dog_breed", "version": 1, "input": { "breed": "Golden Retriever" }, "response": { "format": "json" } }' ``` ```python # Save as fous.py and run with python3 fous.py. No packages needed. # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' import json import os import urllib.error import urllib.request api_key = os.environ.get("FOUS_API_KEY") if not api_key: raise RuntimeError("Set FOUS_API_KEY before running this example") body = json.loads("{\n \"api\": \"@akc\",\n \"visibility\": \"public\",\n \"operation\": \"get_dog_breed\",\n \"version\": 1,\n \"input\": {\n \"breed\": \"Golden Retriever\"\n },\n \"response\": {\n \"format\": \"json\"\n }\n}") request = urllib.request.Request( "https://api.fous.com/v1/query", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json", }, method="POST", ) try: with urllib.request.urlopen(request, timeout=120) as response: result = json.load(response) except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error if result.get("success") is False: raise RuntimeError(result.get("error", {}).get("message", "Request failed")) print(json.dumps(result["data"]["output"], indent=2)) ``` ```typescript // Save as fous.mts and run with npx tsx fous.mts. // First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' const apiKey = process.env.FOUS_API_KEY; if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example"); const response = await fetch("https://api.fous.com/v1/query", { method: "POST", headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", }, signal: AbortSignal.timeout(120_000), body: JSON.stringify({ "api": "@akc", "visibility": "public", "operation": "get_dog_breed", "version": 1, "input": { "breed": "Golden Retriever" }, "response": { "format": "json" } }), }); type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } }; const result: ApiResult = await response.json(); if (!response.ok || result.success === false) { throw new Error(result.error?.message ?? `HTTP ${response.status}`); } if (!result.data) throw new Error("Missing API response data"); console.log(result.data.output); ``` Or describe the data in plain language: send `{"api":"@akc","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same. ## FAQ ### Is Fous affiliated with AKC? No. Fous is not affiliated with AKC. This workflow reads the public akc.org website and returns its data. ### How much does it cost? Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit. ### Do I need a AKC account? No. You only need a Fous account. ### How current is the data? Fous gets the data from akc.org when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026. ## Related - [Emojipedia API](https://fous.com/workflows/emojipedia.md): Emoji meanings, names, and platform designs. - [Yelp API](https://fous.com/workflows/yelp.md): Yelp returns local business matches, public profiles, ratings and up to 60 publicly shown reviews; matches are unsponsored and Yelp-ordered, but later results may lack contact or location details. - [Better Business Bureau API](https://fous.com/workflows/better-business-bureau.md): Better Business Bureau provides business profiles, ratings, accreditation, reviews, alerts, and published complaints, with complaint details limited to those publicly displayed and newest first. - [Hugging Face API](https://fous.com/workflows/hugging-face.md): Hugging Face returns public model, dataset, and demo search results, model details, or weekly trending models; unpublished information may be missing, and demo availability can change. - [Mastodon API](https://fous.com/workflows/mastodon.md): Mastodon provides public profiles and recent public posts, including hashtag posts, but excludes private and unlisted posts and may limit visibility to accounts known to mastodon.social or a selected server. - [Instagram API](https://fous.com/workflows/instagram.md): Instagram provides public photos, videos, profiles, exact headline counts, bio links, and profile pictures, plus recent public posts and reels; some profiles or posts require login, and view counts may be unavailable. - [crates.io API](https://fous.com/workflows/crates-io.md): crates.io is the Rust community package registry, returning current crate details and recent releases or up to 100 keyword-matched crates with version, download, and update information. - [TikTok API](https://fous.com/workflows/tiktok.md): TikTok returns public profiles and totals, recent pinned-first videos, and public video details and engagement; private content unavailable, and feeds may be incomplete or empty. - [All Other workflows](https://fous.com/workflows/category/other)