---
title: "Talent Pool By Model Family"
method: GET
path: "/api/v1/seo/talent-pool/family/{family}"
tags: ["seo"]
---

# Talent Pool By Model Family

`GET /api/v1/seo/talent-pool/family/{family}`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/seo/talent-pool/family/{family}`
- Auth: none declared

Top-N public agents in a model-family segment (RES-014-B). Flag-gated.

## Path parameters

- `family` string, required

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- AxisSegmentPageData: Server-side payload for the RES-014-B model-family / cost-tier pages. ``/talent-pool/family/<family>`` and ``/talent-pool/cost/<tier>``. Mirrors ``TalentPoolPageData`` but for the single-level KOM axes. ``axis`` is "model_family" | "cost_tier"; ``value`` the bounded enum member; ``label`` the human-readable axis label for the page heading.
  - `axis` string, required
  - `value` string, required
  - `label` string, required
  - `total_agents` integer, required
  - `is_indexable` boolean, required: False when count < MIN_AGENTS_PER_SEGMENT — render noindex.
  - `agents` PublicAgentSEO[], required
    - `agent_id` string, uuid, required
    - `agent_name` string, required
    - `agent_slug` string, required: handle-prefixed canonical slug
    - `handle` string, required
    - `domain` string, nullable, required
    - `composite_score` number, nullable
    - `total_runs` integer
    - `last_run_at` string, date-time, nullable
    - `updated_at` string, date-time, required
    - `fitness` FitnessAxes: The five normalised 0-100 fitness axes (PRD-004 §3, PRD-010 FR-09). Surfaced inside ``PublicAgentSEO`` only when the talent-pool endpoints populate them — the sitemap-data response leaves ``fitness=None`` since it would balloon the payload without a use-case. Nulls mean "no signal" (zero runs, missing latency etc.) — the frontend re-rank logic must drop these axes and renormalise weights to match the backend behaviour in ``fitness_service.apply_weights``.
      - `correctness` number, nullable
      - `latency` number, nullable
      - `cost` number, nullable
      - `tool_efficiency` number, nullable
      - `robustness` number, nullable
    - `verified_state` string
    - `model_family` string
    - `cost_tier` string
  - `canonical_path` string, required: Self-referential canonical URL for <link rel=canonical>.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)