Built LMS Help Center
API Reference and PlaygroundCourses and CatalogCourse Search

GET Search courses

Advanced search for courses with multiple filter options including text search, category, difficulty, tags, and duration

GET
/courses/search

Advanced search for courses with multiple filter options including text search, category, difficulty, tags, and duration

Authorization

AuthorizationBearer <token>

Send API keys and access tokens as Authorization: Bearer .

In: header

Query Parameters

q?string

Search query (searches title, description, slug)

limit?integer

Maximum number of results to return

Range1 <= value <= 100
Default25
offset?integer

Number of results to skip for pagination

Range0 <= value
Default0
category?string

Filter by course category

difficulty?string

Filter by difficulty level

Value in

  • "beginner"
  • "intermediate"
  • "advanced"
tags?string

Comma-separated list of tags to filter by

min_duration?integer

Minimum duration in minutes

Range0 <= value
max_duration?integer

Maximum duration in minutes

Range0 <= value
published_only?boolean

Only return published courses

Defaultfalse
sort_by?string

Field to sort by

Default"created_at"

Value in

  • "created_at"
  • "updated_at"
  • "title"
  • "duration_minutes"
sort_order?string

Sort order

Default"desc"

Value in

  • "asc"
  • "desc"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/courses/search"
{  "data": [    {      "id": "{id}",      "title": "string",      "slug": "string",      "description": "string",      "category": {        "id": "{id}",        "name": "string"      },      "difficulty": "beginner",      "duration_minutes": 0,      "thumbnail_url": "string",      "status": "draft",      "statistics": {        "enrollment_count": 0,        "completion_rate": 0      },      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "organization_id": "{organization_id}",    "total": 0,    "total_count": 0,    "limit": 0,    "offset": 0,    "has_more": true,    "requested_at": "2019-08-24T14:15:22Z"  }}