# 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/tools/akc
- Handle: `@akc`
- Category: [Other](https://fous.com/tools/category/other)
- Source website: https://akc.org
- Last verified: Sep 29, 2026

## Methods

### Get dog breed

Operation `get_dog_breed`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_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.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

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=180) 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.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_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);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/akc`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_dog_breed`: Get dog breed. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-akc https://api.fous.com/mcp/tools/akc --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this AKC tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. 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. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

## Related

- [Emojipedia API](https://fous.com/tools/emojipedia.md): Emoji meanings, names, and platform designs.
- [Yelp API](https://fous.com/tools/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/tools/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/tools/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/tools/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/tools/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/tools/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.
- [Chewy API](https://fous.com/tools/chewy.md): Search pet food, supplies, and pharmacy products on Chewy.
- [All Other tools](https://fous.com/tools/category/other)