Content API

Browse and retrieve content from your ingested library. Useful for building resource browsers, content libraries, or displaying available documentation.

List content

Browse available content with pagination and filtering.

GET/widget/content

Query parameters

pageinteger

Page number (starts at 1, default 1).

per_pageinteger

Items per page (1-100, default 20).

section_typestring

Filter by section type.

source_typestring

Filter by source type.

webpagepdfyoutube

Request

curl "https://api.isomera.ai/api/v1/widget/content?section_type=dosing" \
  -H "X-API-Key: wk_your_api_key"

Response

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Dosing Information",
      "content": "The starting dose is 0.25 mg injected subcutaneously once weekly...",
      "section_type": "dosing",
      "source_type": "webpage",
      "source_url": "https://example.com/dosing"
    }
  ],
  "total": 10,
  "page": 1,
  "per_page": 20,
  "has_more": false
}

Get content item

Retrieve full details for a specific content item.

GET/widget/content/{content_id}

Path parameters

content_idstringrequired

UUID of the content item.

Response

contentstring

Full content text.

video_idstring | null

YouTube video ID for video content.

timestamp_startinteger | null

Video segment start time in seconds.

timestamp_endinteger | null

Video segment end time in seconds.

Request

curl "https://api.isomera.ai/api/v1/widget/content/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: wk_your_api_key"

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Dosing Information",
  "section_header": "Starting Dose and Escalation",
  "content": "The starting dose is 0.25 mg injected subcutaneously once weekly. This starting dose is intended to reduce gastrointestinal symptoms during initial dose escalation...",
  "section_type": "dosing",
  "source_type": "webpage",
  "source_url": "https://example.com/dosing",
  "video_id": null,
  "video_duration_seconds": null,
  "timestamp_start": null,
  "timestamp_end": null,
  "created_at": "2024-12-11T10:00:00Z"
}

Video content response

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "title": "Injection Tutorial",
  "content": "In this video, we'll walk through how to properly administer your injection...",
  "section_type": "dosing",
  "source_type": "youtube",
  "source_url": "https://youtube.com/watch?v=abc123",
  "video_id": "abc123",
  "video_duration_seconds": 245,
  "timestamp_start": 30,
  "timestamp_end": 90,
  "timestamp_display": "0:30 - 1:30",
  "thumbnail_url": "https://img.youtube.com/vi/abc123/default.jpg"
}