CourtListener Scraper: Opinions, Dockets & Full Text
Pricing
from $5.00 / 1,000 opinion with full texts
CourtListener Scraper: Opinions, Dockets & Full Text
Scrape CourtListener US court opinions with full text, dockets, oral arguments, judges, citations, and RAG-ready chunks for legal research and AI. Bring your own CourtListener API token if you have one.
Pricing
from $5.00 / 1,000 opinion with full texts
Rating
0.0
(0)
Developer
Proooxy
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
16 days ago
Last modified
Categories
Features
Share
Scrape US case law from CourtListener (Free Law Project): court opinions with complete full text — not just the search snippets every other scraper returns — plus dockets, oral arguments, judges and citation lookups. Built to survive CourtListener's 2026 rate-limit changes.
💡 Why this one
- Full opinion text, not snippets. Competing actors return the ~300-character search snippet. This Actor follows each result into the database endpoint and returns the complete opinion (
html_with_citations), cleaned and chunked for RAG. - Rate-limit aware. In May 2026 CourtListener cut the free tier to 5/min, 50/hr, 125/day. This Actor paces itself to your tier and handles throttling responses in both formats CourtListener uses (DRF text and the citation-lookup
wait_untilJSON), backing off precisely instead of failing. - No token needed to start. The Actor brings its own CourtListener token; set
apiTokento run on your own token and its rate budget.
🎯 Features
| Feature | Description |
|---|---|
| ⚖️ Opinions | Case-law search with full opinion text + RAG chunks |
| 📁 Dockets / RECAP | Federal dockets and RECAP documents with parties, judges, nature of suit |
| 🎧 Oral arguments | Argument audio metadata with download URLs |
| 👤 Judges | Judge profiles (the "people" database) |
| 🔎 Citation lookup | Resolve citation strings (e.g. 576 U.S. 644) to cases |
🚀 Quick Start
{"apiToken": "OPTIONAL_COURTLISTENER_TOKEN_OVERRIDE","searchType": "opinions","query": "qualified immunity","court": "scotus","includeFullText": true,"maxItems": 50}
📋 Input
| Field | Type | Description |
|---|---|---|
apiToken | string (secret) | Optional. Your own free token from courtlistener.com/profile/apikeys, to run on your own rate budget; leave empty to use the Actor's |
searchType | string | opinions, dockets, recap_docs, oral_arguments, judges, citation |
query | string | Full-text query with boolean operators (AND/OR/NOT) and field prefixes |
citations | array | Citation strings to resolve (when searchType is citation) |
court | string | Court ID, e.g. scotus, ca9, nyed |
dateFrom / dateTo | string | Filing-date range (YYYY-MM-DD) |
orderBy | string | score desc, dateFiled desc, citeCount desc… |
includeFullText | boolean | Fetch complete opinion text + chunks (opinions only; default true) |
chunking | string | paragraph (~2000 chars) or none |
requestsPerMinute | integer | Throttle to your tier — keep at 4 for the free tier, raise it with a membership |
maxItems | integer | Max items to save (default 100) |
📤 Output
{"itemType": "legal","searchType": "opinions","id": "10380001","title": "Climate United Fund v. Citibank, N.A.","court": "Court of Appeals for the D.C. Circuit","date": "2025-04-16","url": "https://www.courtlistener.com/opinion/10380001/...","citations": [],"citeCount": 0,"fullText": "...","chunks": [{ "text": "...", "order": 0 }],"meta": { "courtId": "cadc", "clusterId": 10380001 }}
🍳 Recipes
1. Build a case-law RAG corpus
Pull a court's opinions with full text, chunked for embeddings:
{"apiToken": "OPTIONAL_TOKEN_OVERRIDE","searchType": "opinions","query": "first amendment retaliation","court": "ca9","includeFullText": true,"chunking": "paragraph","maxItems": 200}
2. Resolve a brief's citations
Turn a list of citations into linked cases:
{"apiToken": "OPTIONAL_TOKEN_OVERRIDE","searchType": "citation","citations": ["576 U.S. 644", "410 U.S. 113", "347 U.S. 483"]}
3. Track a court's docket activity
{"apiToken": "OPTIONAL_TOKEN_OVERRIDE","searchType": "dockets","query": "antitrust","court": "nysd","dateFrom": "2026-01-01","maxItems": 100}
💳 Pricing
Pay-per-event: $0.005 per opinion (with full text), $0.002 per docket / oral argument / judge / citation. A 1,000-opinion corpus costs $5.00.
❓ FAQ
Do I need a token?
Not to start. CourtListener requires a token, and the Actor brings its own. Set apiToken to use your own token and its rate budget. Tokens are free at courtlistener.com/profile/apikeys. Researchers can request an EDU membership for higher limits.
How fast can it go?
As fast as your tier allows. The free tier is 5 requests/minute since May 2026 — set requestsPerMinute to 4 and the Actor paces itself and backs off on throttling. With a membership, raise it.
Why is full text better than what other scrapers return?
The search API only returns a short snippet. This Actor fetches the opinion record itself, so you get the entire decision — essential for RAG, citation analysis, or fine-tuning.
⚠️ Legal & Compliance
CourtListener is operated by the non-profit Free Law Project and serves public-domain US court records. This Actor respects the rate limits attached to the token it uses and accesses only public data. Please review CourtListener's terms.
🤖 Use with AI agents
This Actor is callable as a tool by any MCP-capable agent — Claude, Cursor, VS Code — or by your own code, with no wrapper and nothing extra to deploy.
Connect over MCP
https://mcp.apify.com?tools=autofacts/courtlistener-scraper
In a client that reads an mcpServers configuration block:
{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=autofacts/courtlistener-scraper","headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }}}}
The agent reads this Actor's parameters and their descriptions straight from the input schema, and the hosted server infers the result field types from the dataset schema — so a model knows what to send and what comes back before it ever calls anything.
Or call the API directly
curl -X POST "https://api.apify.com/v2/acts/autofacts~courtlistener-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \-H 'Content-Type: application/json' \-d '{"query": "climate change"}'
The response body is the dataset records described above.
🧰 Other Actors by autofacts
Apify only auto-recommends Actors in the same category, so here are the ones that actually pair with this scraper:
| Actor | What it's for |
|---|---|
| SEC EDGAR Scraper | Company filings, full text and XBRL financial facts |
| USAspending.gov Scraper | US federal awards, contracts and grants |
| Clinical Trials Scraper | Studies, sponsors and results from ClinicalTrials.gov |
| HTML to PDF & URL to PDF API | Turn any URL or HTML into PDF, PNG, JPEG or WebP |
All of them: apify.com/autofacts