Get an oral-argument transcript
get_oral_argumentFetch U.S. Supreme Court oral argument transcripts for a case and filter turns by Justice, advocate, keyword, or start time.
Instructions
Fetch the oral-argument transcript for a case, optionally filtered by speaker, by text, or from a point in time.
The transcript is returned as "Speaker: text" turns. Use the filters to zero in on, for example, one Justice's questions ("only Justice Scalia's questions" -> speaker="Scalia") or every turn that mentions a word (find="personhood"). A full argument is far longer than the default cap; to read one straight through, follow the note at the end of a truncated transcript, which names the part and start to continue from.
Args: term: The Term year, e.g. "2014". docket: The docket number, e.g. "14-556". speaker: Case-insensitive substring of a speaker's name; include only their turns (e.g. "Scalia", "Verrilli", "Roberts"). speaker_type: "justice" or "advocate" to include only that group. Someone who argued the case before joining the Court (Kagan as Solicitor General, say) counts as an advocate. find: Case-insensitive text; include only the turns that contain it (e.g. "corporate", "personhood"). Combine with speaker_type for what one side said about it. start: Resume at this point in the recording, as "H:MM:SS", "M:SS", or seconds. Turns before it in the first selected session are skipped; give part as well when there are several sessions. part: For arguments split into sessions, the 1-based session index; default is all sessions. include_timestamps: Prefix each turn with its start time (H:MM:SS). max_chars: Soft cap on transcript length, 1000-200000 (default 18000). When hit, output is truncated with a note that says where to continue from.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| find | No | ||
| part | No | ||
| term | Yes | ||
| start | No | ||
| docket | Yes | ||
| speaker | No | ||
| max_chars | No | ||
| speaker_type | No | ||
| include_timestamps | No |