---
title: "Search learning components"
method: GET
path: "/learning-components/search"
tags: ["Learning Components", "Search"]
---

# Search learning components

`GET /learning-components/search`

<Warning>This endpoint is for free-text semantic search across learning component descriptions. To retrieve learning components for a specific standard, use [Components for a standard](/api-reference/learning-components/learning-components-for-a-standard) instead.</Warning>

Searches for LearningComponents using semantic search against learning component descriptions.

Results are ranked by relevance to the query text and include a `score` reflecting vector similarity. Use the optional `academicSubject` filter to narrow results to a specific subject area.

Use this endpoint when you need to:
- Find learning components relevant to a specific skill or concept
- Discover granular instructional targets related to a teaching goal
- Search for LCs to map to your own content or assessments

**Related topics:**
- [Understanding Learning Components](/knowledge-graph/graph-reference/learning-components)
- [Available LC coverage by subject and state](/knowledge-graph/graph-reference/learning-components#current-lc-mappings)

## Query parameters

- `query` string, required
- `academicSubject` 'English Language Arts' | 'Mathematics' | 'Science' | 'Social Studies' | 'Other' — Academic subject area
- `limit` integer

## Response `200`

Successfully retrieved search results (ranked by relevance)

- LearningComponentSearchResult[]
  - `identifier` string, required — Unique identifier for the resource in Knowledge Graph
  - `description` string, nullable — Description of the specific skill or concept represented
  - `author` string, required — Author or creator of the resource
  - `provider` string, required — Source data provider for the resource
  - `license` string, uri, required — URL to the resource's license document
  - `attributionStatement` string, required — Statement that acknowledges the resource's author and provider, as required by the CC BY 4.0 license
  - `score` number, float, required — Relevance score between 0 and 1 (reflects vector similarity for semantic search)

## Other responses

- `400` — Bad request - Missing required query parameter
- `422` — Unprocessable Entity - Invalid parameter values (e.g., enum value not in allowed list)
- `500` — Internal server error

---

[API](https://skmtc.dev/learningcommons/apis/learning-commons-knowledge-graph-rest-api.md) · [All operations](https://skmtc.dev/learningcommons/apis/learning-commons-knowledge-graph-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/learningcommons/learning-commons-knowledge-graph-rest-api/revisions/87a44fbb081f/schema)