Top Class Actions Scraper

Scrape TopClassActions.com for class-action lawsuit settlements, legal news, and active case-tracker entries. Get settlement eligibility criteria, potential award amounts, proof-of-purchase requirements, claim-form deadlines, case names, settlement websites, claims administrators, and legal counsel — all structured and ready to use.

Whether you're building a settlement-alert tool, researching consumer-rights cases, monitoring a specific company's litigation history, or tracking claim deadlines, this actor gives you clean, structured access to TopClassActions' entire public catalog.

What this actor does

• Eight modes: latest articles, full-text search, browse by category/company, open settlements (currently accepting claims), closed settlements (claims period ended), the active case tracker, the legal/medical glossary, and exact-URL lookup
• Settlement "quick facts" extraction: who's eligible, potential award, proof of purchase, claim-form deadline, exclusion/objection deadline, case name, final hearing date, settlement website, claims administrator, class counsel, defense counsel
• 700+ categories: browse by company (Amazon, Apple, BMW, Bank of America, ...) or by topic (data breach, auto news, banking news, beauty products, ...)
• Date-range filtering on publish date
• No login, no cookies, no proxy required — reads the site's public REST API

Output fields

Every record includes:

• postId, title, sourceUrl, slug
• publishedAt, modifiedAt (UTC)
• excerpt — plain-text summary
• bodyText — full plain-text article/settlement body (HTML tags stripped)
• featuredImageUrl
• categories[], tags[]
• author — the byline (e.g. "Top Class Actions" or a named staff writer)
• readingTimeMinutes — estimated reading time in minutes
• wordCount — article/settlement body word count (articles and settlements only, not case-tracker entries)
• commentCount — number of reader comments on the post (articles and settlements only, not case-tracker entries)
• recordType — article, settlement, or caseTrackerEntry

Settlement records (mode openSettlements/closedSettlements, or any article that has a settlement "quick facts" box) additionally include, where available:

• whosEligible — who qualifies to file a claim
• potentialAward — the payout amount/range
• proofOfPurchase — what documentation is required
• claimFormDeadline — the filing deadline
• exclusionObjectionDeadline — the deadline to opt out of or object to the settlement
• caseName — the legal case name and docket number
• finalHearing — the court's final approval hearing date
• settlementWebsite — the official claims-administrator site
• claimFormUrl — direct link to file a claim online, when the settlement offers one
• claimsAdministrator, classCounsel, defenseCounsel
• settlementStatus — "open" (mode=openSettlements) or "closed" (mode=closedSettlements)
• settlementAmountRaw — the total settlement fund amount as displayed in the headline, e.g. "$359.9M" or "$750,000" (omitted when the headline doesn't lead with a dollar figure)
• settlementAmountUsd — the same amount normalized to a plain USD number, e.g. 359900000

Fields that TopClassActions hasn't published for a given record (e.g. a settlement with no fixed deadline, or a plain news article with no quick-facts box) are simply omitted — never sent as null or "N/A".

Glossary records (mode glossary, recordType: "glossaryTerm") are a separate record shape — plain-English definitions of legal/medical terms that come up in class-action cases (e.g. "What is shoulder dystocia?"), not articles:

• postId, term (the glossary headword/question), sourceUrl, slug
• publishedAt, modifiedAt (UTC)
• definition — full plain-text glossary entry (HTML tags stripped)
• letter — the A-Z index letter TopClassActions files this term under
• glossaryCategory — TopClassActions' own topical grouping for the term (e.g. General)
• featuredImageUrl, readingTimeMinutes
• recordType: "glossaryTerm", scrapedAt

Input

Field	Type	Default	Description
mode	select	openSettlements	latest / search / byCategory / openSettlements / closedSettlements / caseTracker / glossary / byUrls
searchQuery	string	– (Console suggests settlement)	Free-text query (required for mode=search; optional narrowing filter by case name/company for mode=caseTracker; optional narrowing filter by term/definition for mode=glossary — leave blank to fetch entries unfiltered)
categorySlug	string	–	Category/company slug, e.g. data-breach, amazon-class-action-lawsuit-and-settlement-news, apple-open-settlements
tagSlug	string	–	Optional topic-tag slug narrowing filter (separate taxonomy from categorySlug), e.g. abortion, data-breach, data-privacy. Not applicable to mode=byUrls/caseTracker/glossary
glossaryLetter	select	–	Optional A-Z narrowing filter for mode=glossary — only return terms filed under that letter
postUrls	array	[]	Exact article/settlement page URLs to fetch directly (mode=byUrls)
dateFrom	string	–	Only articles published on/after this date (YYYY-MM-DD)
dateTo	string	–	Only articles published on/before this date (YYYY-MM-DD)
sortOrder	select	newest	newest / oldest / relevance (search only)
maxItems	integer	30	Max records to return

Modes explained

• latest — the most recent articles and settlement posts across the entire site, optionally narrowed with categorySlug.
• search — full-text search across all published posts.
• byCategory — browse a specific category or per-company archive (requires categorySlug).
• openSettlements (default) — the curated list of class-action settlements currently accepting claims. Narrow to one company with categorySlug (e.g. apple-open-settlements).
• closedSettlements — settlements whose claims period has ended (historical record). Narrow to one company with categorySlug (e.g. apple-closed-settlements).
• caseTracker — active lawsuits and investigations tracked by TopClassActions' Case Tracker (before they become open settlements). Optionally narrow with searchQuery to match a case name or company.
• glossary — TopClassActions' legal/medical term glossary (e.g. "What is shoulder dystocia?", "What is strict liability?") — plain-English definitions of terms that come up across class-action cases. Optionally narrow with searchQuery (matches term/definition text) and/or glossaryLetter (A-Z index).
• byUrls — fetch exact article or settlement page URLs directly (postUrls), resolved via the post's URL slug. Useful for refreshing a known set of settlement pages without re-browsing a category.

Example: currently open settlements

{
  "mode": "openSettlements",
  "maxItems": 30
}

Example: one company's settlement history

{
  "mode": "closedSettlements",
  "categorySlug": "apple-closed-settlements",
  "maxItems": 20
}

Example: search by keyword with a date range

{
  "mode": "search",
  "searchQuery": "data breach settlement",
  "dateFrom": "2026-01-01",
  "maxItems": 30
}

Example: active case tracker

{
  "mode": "caseTracker",
  "searchQuery": "T-Mobile",
  "maxItems": 20
}

Use cases

• Build a daily digest of new class-action settlements you might be eligible for
• Monitor a specific company's (e.g. Amazon, Apple, T-Mobile) ongoing litigation and settlement history
• Feed a legal-research database with structured settlement metadata (deadlines, eligibility, payouts)
• Track claim-form deadlines across many open settlements at once
• Power a consumer-facing settlement-alert app or newsletter
• Research legal/medical terminology relevant to a case via the glossary mode

FAQ

Do I need an account or API key? No. This actor reads TopClassActions' public content and requires no login, cookies, or API key.

How do I find a category slug? Browse topclassactions.com, open any category/company archive page, and copy the last segment of the URL (e.g. https://topclassactions.com/category/.../data-breach/ → data-breach).

Why don't all settlement records have every field (e.g. claimFormDeadline)? TopClassActions doesn't publish every field for every settlement — some deadlines are marked "N/A" (rolling claims, no fixed deadline) or aren't disclosed. This actor omits fields it can't populate with real data rather than sending placeholders.

Does this actor cover pending or closed settlements too? Yes — use mode=closedSettlements for the full historical archive of settlements whose claims period has ended, optionally narrowed to one company with categorySlug (e.g. apple-closed-settlements). You can also use byCategory with any *-pending-settlements slug, or latest/search without restricting to openSettlements.

Is this actor reliable for daily monitoring? Yes. It reads TopClassActions' standard WordPress REST API over plain HTTPS, has automatic retry-with-backoff on rate limits/server errors, and requires no residential proxy or session management.