> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learningcommons.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Search learning components
> 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.
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)
## OpenAPI
````yaml /api-reference/knowledge-graph-api/openapi.yaml get /learning-components/search
openapi: 3.0.3
info:
title: Learning Commons Knowledge Graph REST API
description: >
REST API for accessing education knowledge graph data including academic
standards, learning components, and curriculum information.
**Key datasets:**
- **Academic Standards**: Official state standards from all 50 U.S. states
sourced from 1EdTech's CASE Network
- **Learning Components**: Granular, teachable skills that break down broad
standards into actionable instructional units
- **Standards Crosswalks**: Connections between standards and frameworks
- **Curriculum**: Structured course content including courses, lesson
groupings (units, sections, modules), lessons, activities, and assessments
**Learn more:**
- [Knowledge Graph
Overview](/knowledge-graph/understanding-knowledge-graph/introduction)
- [Academic Standards](/knowledge-graph/graph-reference/academic-standards)
- [Learning
Components](/knowledge-graph/graph-reference/learning-components)
- [Standards
Crosswalks](/knowledge-graph/graph-reference/standards-crosswalks)
- [Curriculum](/knowledge-graph/graph-reference/curriculum)
- [Quickstart](/knowledge-graph/getting-started/quickstart)
version: '0'
servers:
- url: https://api.learningcommons.org/knowledge-graph/v0
description: Production server
security:
- ApiKeyAuth: []
tags:
- name: Academic Standards
description: Academic standards operations
- name: Curriculum
description: Curriculum operations
- name: Hierarchy
description: Hierarchical navigation operations
- name: Learning Components
description: Learning components operations
- name: Learning Progressions
description: Learning progressions operations
- name: Search
description: Search and discovery operations
- name: Standards Crosswalks
description: Standards crosswalks operations
paths:
/learning-components/search:
get:
tags:
- Learning Components
- Search
summary: Search learning components
description: >
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.
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)
operationId: searchLearningComponents
parameters:
- name: query
in: query
required: true
description: >-
Free-text query for semantic search against learning component
descriptions
schema:
type: string
maxLength: 500
- $ref: '#/components/parameters/AcademicSubjectParam'
- name: limit
in: query
required: false
description: Maximum number of results to return
schema:
type: integer
minimum: 1
maximum: 50
default: 5
responses:
'200':
description: Successfully retrieved search results (ranked by relevance)
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/LearningComponentSearchResult'
example:
- identifier: 0013fbee-3e76-500f-9978-42aa1a65f105
description: Use conversions to solve multi-step real-world problems
author: Achievement Network
provider: Learning Commons
license: https://creativecommons.org/licenses/by/4.0/
attributionStatement: >-
Knowledge Graph is provided by Learning Commons under the CC
BY-4.0 license. Learning Commons received learning
components under CC BY-4.0 from Achievement Network.
score: 0.94
- identifier: 0046446a-0a9b-5ace-92a3-23d4bb158c68
description: >-
Determine the lateral surface area of three-dimensional
cylinders in real-world problems
author: Achievement Network
provider: Learning Commons
license: https://creativecommons.org/licenses/by/4.0/
attributionStatement: >-
Knowledge Graph is provided by Learning Commons under the CC
BY-4.0 license. Learning Commons received learning
components under CC BY-4.0 from Achievement Network.
score: 0.81
'400':
description: Bad request - Missing required query parameter
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: ValidationError
message: >-
Missing required parameter: query. Example:
?query=solve+multi-step+real-world+problems
requestId: req_12345
'422':
description: >-
Unprocessable Entity - Invalid parameter values (e.g., enum value
not in allowed list)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: ValidationError
message: >-
Input should be 'English Language Arts', 'Mathematics',
'Science', 'Social Studies', or 'Other'
requestId: req_12345
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: InternalServerError
message: >-
An unexpected error occurred while searching for learning
components
requestId: req_12345
components:
parameters:
AcademicSubjectParam:
name: academicSubject
in: query
required: false
schema:
$ref: '#/components/schemas/AcademicSubjectENUM'
schemas:
LearningComponentSearchResult:
description: >-
A LearningComponentSummary enriched with a relevance score from the
search.
allOf:
- $ref: '#/components/schemas/LearningComponentSummary'
- type: object
required:
- score
properties:
score:
type: number
format: float
minimum: 0
maximum: 1
description: >-
Relevance score between 0 and 1 (reflects vector similarity for
semantic search)
Error:
type: object
description: Standard error response object returned for all error conditions
required:
- error
- message
- requestId
properties:
error:
type: string
description: >-
Machine-readable error type identifier (e.g., `ValidationError`,
`NotFoundError`, `InternalServerError`)
message:
type: string
description: >-
Human-readable error message that explains what went wrong and may
include actionable guidance
requestId:
type: string
description: Unique identifier for this request (for debugging and support)
details:
type: object
description: >-
Optional additional details about the error, such as validation
failures or field-specific issues
additionalProperties: true
AcademicSubjectENUM:
type: string
description: Academic subject area
enum:
- English Language Arts
- Mathematics
- Science
- Social Studies
- Other
LearningComponentSummary:
type: object
description: >
A lightweight representation of a LearningComponent containing only
essential information.
This summary format is used in relationship endpoints (standards to
learning components) to keep responses fast and enable efficient
traversal. To retrieve full details for a learning component, use the
GET /learning-components/{identifier} endpoint.
required:
- identifier
- author
- provider
- license
- attributionStatement
properties:
identifier:
type: string
description: Unique identifier for the resource in Knowledge Graph
description:
type: string
nullable: true
description: Description of the specific skill or concept represented
author:
type: string
description: Author or creator of the resource
provider:
type: string
description: Source data provider for the resource
license:
type: string
format: uri
description: URL to the resource's license document
attributionStatement:
type: string
description: >-
Statement that acknowledges the resource's author and provider, as
required by the CC BY 4.0 license
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: API key for authentication
````