Skip to main content

Lookup verse by timestamp​

Find the closest verse timing segment for a reciter and chapter at the given timestamp. All time values are milliseconds.

Path Parameters
    reciter_id integer required

    The Id of the reciter

Query Parameters
    chapter_number integer

    Possible values: >= 1 and <= 114

    Chapter number (1 - 114). Required unless you provide verse_key or verse_id.

    verse_key string

    Verse key (e.g., 2:255). Used only to derive the chapter when chapter_number is omitted.

    verse_id integer

    Verse id. Used only to derive the chapter when chapter_number is omitted.

    timestamp integer required

    Timestamp in milliseconds to look up.

    segments boolean

    If true, include word-level timing segments for the verse.

Responses

Successful response

Schema
    result object
    verse_key string
    timestamp_from int32

    Start offset in milliseconds from the beginning of the file.

    timestamp_to int32

    End offset in milliseconds from the beginning of the file.

    duration int32

    Duration in milliseconds (mirrors source data; may be negative in legacy data).

    segments array[] nullable

    Possible values: >= 3, <= 3

    Present only when segments=true. Word-level timing triplets for the verse.

Loading...