Trace Footprints — Browse & Search API

Catalog reads are public and served from data/footprints_index.json (no backend), except semantic search, which proxies to the backend vector index with a local text fallback. Footprints are browsed by library, not category.

Search / list — `GET /api/footprints`

string

Case-insensitive match over name, description, tags, library.

number

default:"1"

number

default:"60"

Capped at 100.

Footprint[]

number

curl "https://footprints.buildwithtrace.com/api/footprints?q=QFN&limit=20"

import { searchFootprints } from "@/lib/api";
const { footprints, total } = await searchFootprints("QFN", { limit: 20 });

{ "footprints": [ { "id": "Package_DFN_QFN:QFN-16…", "name": "QFN-16-1EP_3x3mm_P0.5mm",
  "library": "Package_DFN_QFN", "tags": "QFN 0.5", "padCount": 17,
  "pads": [ { "number": "1", "type": "smd" } ], "source": "trace" } ],
  "total": 771, "page": 1, "limit": 20, "totalPages": 39 }

/api/footprints is search/list only (q, page, limit). The footprint detail page is a Server Component that reads the index directly via getFootprintById() — it does not call this route.

Browse by library

There is no library-list API route — libraries come from the index via the data layer:

import { getAllFootprintLibraries, getTopFootprintLibraries, getFootprintsByLibrary } from "@/lib/footprints";

getTopFootprintLibraries(12);                 // homepage "Browse by Library" grid
getFootprintsByLibrary("Package_DFN_QFN", 1, 120);   // /browse/[library] page

Each returns { id, name, footprintCount } (libraries) or a paginated FootprintSearchResult (footprints in a library).

Semantic search — `GET /api/search/semantic`

string

required

Minimum 2 characters.

number

default:"20"

Capped at 50.

Proxies to GET /api/v3/components/search?q=&limit=&type=footprint. Returns source: "vector" on success or source: "text_fallback" when the backend is unreachable. Result items use the backend’s snake_case (pad_count).

{ "results": [ { "name": "…", "library": "…", "description": "…", "pad_count": 16 } ],
  "query": "…", "total": 8, "source": "vector" }

Getting Started

Core Concepts

Guides

Browse & Search (Footprints)

Search / list — `GET /api/footprints`

Browse by library

Semantic search — `GET /api/search/semantic`

​Search / list — GET /api/footprints

​Browse by library

​Semantic search — GET /api/search/semantic

Search / list — `GET /api/footprints`

Browse by library

Semantic search — `GET /api/search/semantic`