Ctrlk
Donate
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Lumen

A research project collecting and publishing legal takedown notices for online content transparency

URL

https://lumendatabase.org (last update May, 2026)

Description

Lumen is a Harvard Law School Library research database of legal complaints and content-removal requests, including DMCA, defamation, court-order, trademark, privacy, and other takedown demands submitted to online services. As of June 2026, it hosts over 75 million notices that reference over 10 billion URLs, and Lumen says the database grows by more than 200,000 notices per week. Investigators can search notices by keywords, senders and recipients, topics, jurisdictions, dates, and quoted exact phrases.

Key use cases and features:

  • Notices Repository: Lumen keeps a collection of important notices, like DMCA claims, defamation issues, privacy concerns, trademark matters, and court orders. Each notice shares details about the sender and recipient, such as who requested the content removal and which hosting or search service was involved. It also provides a brief overview of the reasons for the request and includes the URLs of the content being questioned.

  • Search and Filtering: full‑text query plus facets (notice type, sender, recipient, date, language, etc.). Since Jun 2024 users can run exact‑match searches by quoting a phrase and, if logged‑in as researchers, add individual notices to a personal “watch” list to be alerted of updates.

  • API for Advanced Research Researchers and investigative journalists can obtain API credentials to automate queries for large-scale data analysis. The API supports:

    • Searching by keywords, date ranges, parties involved, etc.

    • Retrieving entire notices as JSON for customized analytics.

    • Programmatic data collection over time to identify trends in takedown requests.

Lumen’s overarching goal is to bring transparency to the ecosystem of online content removal requests. It aims to be an independent, research-driven clearinghouse of takedown notices, allowing journalists, researchers, and the public to see who is requesting that specific web content or links be taken down and why. Lumen does not validate or endorse these requests; rather, it archives them to facilitate academic study, watchdog journalism, and informed civic debate.

When/Why a Researcher or Journalist Might Use Lumen

  1. Investigating Patterns of Censorship or Overreach:

    • Example: A politician repeatedly using DMCA notices to remove critical blog posts.

    • Outcome: You can uncover if the same entity has filed multiple notices across different platforms to silence certain views.

  2. Checking the Legitimacy of a Takedown Claim:

    • Example: You receive a tip that content on YouTube was flagged for copyright infringement, but you suspect it’s fair use.

    • Outcome: A search of Lumen might reveal a DMCA notice that either lacks a credible claim or is suspiciously similar to notices flagged as fraudulent.

  3. Examining Geopolitical or Government Interventions:

    • Example: A ministry in Country X demands the removal of “defamatory” content from Google or a social network.

    • Outcome: Lumen’s archive can reveal the scope of government requests, including how often and for what reasons they are made.

  4. Researching Corporate Takedown Practices:

    • Example: You want to see if a major film studio issues an unusually high number of DMCA requests for minor social-media posts.

    • Outcome: By aggregating data in Lumen, patterns may emerge, helping you question potentially excessive takedowns.

What Lumen Shows

A Lumen Database search query for “AfD” displaying multiple takedown notices, each labeled by complaint type (e.g., trademark, defamation) and showing key fields like sender, recipient, and date received. (Filtered by language DE.)

  • Full or partially redacted copies of notices:

    • Sender (often a rights-holder, law firm, or government agency)

    • Recipient (Google, Vimeo, Medium, or others)

    • Target URLs and reason (e.g. copyright, defamation, trademark)

  • Contextual metadata:

    • Date sent/received

    • Claimed legal grounds (DMCA, local law, court order)

    • Whether the recipient took action (partial or none)

  • Research Tools:

    • Searchable indexes and filtering (dates, keywords, notice type)

    • API access for data mining and in-depth analysis

Example of a Basic API Query

Below is a short sample of how a journalist or researcher might retrieve data via Lumen’s API (assuming they have an API token and some familiarity with command-line tools like curl). This example queries for notices that contain the term “fraud” in their text or metadata, from a date range, and returns the first page of JSON results.

Explanation:

  • term=fraud: Searches for notices containing the word “fraud” in their text.

  • date_received_facet=1672531200000..1704067200000: Limits results to notices received between two Unix timestamps (e.g., 01 Jan 2023 to 01 Jan 2024).

  • page=1: Retrieves the first set of results.

  • -H "X-Authentication-Token: YOUR_API_TOKEN": Authenticates you as a recognized researcher.

  • Accept: application/json: Ensures responses return in JSON, which is easily parsed by scripts or data-analysis tools.

You will receive a JSON object listing all matching takedown notices, each with fields like id, title, date_received, sender_name, and more. By iterating through page values, or narrowing your date range, you can gather larger sets of notices over time.

Advanced API examples

1. Searching for a Keyword with Date Range

Scenario: You want to see all takedown notices referring to “piracy” from January 1, 2023 through January 1, 2024.

  • term=piracy: Looks for “piracy” in any notice field.

  • date_received_facet=1672531200000..1704067200000: Restricts notices to those received between the two timestamps (Jan 1, 2023 and Jan 1, 2024).

  • sort_by=date_received asc: Sorts results by oldest first (ascending).

  • This returns JSON with an array of notices that match your criteria, including fields like id, title, body, sender_name, recipient_name, etc.

2. Exact Phrase Searches

Scenario: You suspect certain notices mention an exact phrase—e.g. “copyright troll”—and want only those that contain that entire phrase, not just the words separately.

  • term="%22copyright%20troll%22" (URL-encoded quotes) searches for the exact phrase “copyright troll.”

  • By default, Lumen’s search is flexible with spacing and partial matches; quoting your query forces exact matching of the entire phrase.

3. Filtering by Sender Name and Topic

Scenario: You want to find all notices sent by a specific party (the sender_name) who has repeatedly filed DMCA takedowns about “videos.” Also, you only want notices classified under Copyright topics.

  • term=video: Broad text search for “video.”

  • sender_name_facet=Company%20XYZ: Limits results to those where “Company XYZ” was the stated sender.

  • topic_facet=Copyright: Restricts results to notices tagged under the Copyright topic.

4. Looking Up Notices by Principal (Rightsholder)

Scenario: You suspect a major law firm is filing notices on behalf of a big music label. You want to see everything posted on behalf of that label.

  • principal_name=Big%20Music%20Label: Finds all notices where the “principal” (the actual rightsholder or client) is “Big Music Label.”

  • The response includes details like date_sent, body (if not redacted), and any URLs claimed to be infringing.

5. Searching by Tag, Action Taken, and Language

Scenario: You want takedown notices about “fake news” specifically tagged with “misinformation,” and you only want to see those that had “Partial” action taken, in Spanish.

  • term="%22fake%20news%22": The exact phrase “fake news.”

  • tags=misinformation: Only those notices with “misinformation” as a tag.

  • action_taken_facet=Partial: The platform partially complied with the request.

  • language_facet=es: The notice text is recorded as Spanish.

6. Combining Multiple Queries (Sender & Keyword & Date Range)

Scenario: You suspect the same actor used different angles—defamation, copyright, trademark—to remove social media criticism. Combine a keyword (“criticism”), a date range, and the sender's name.

  • term=criticism: The word “criticism” anywhere in notice text or fields.

  • sender_name=Some%20Law%20Office: The name of the firm sending the notices.

  • date_received_facet=1669852800000..1693612800000: Restricts results to notices received between Dec 1, 2022 and Sep 2, 2023 (example date range).

7. Retrieving a Specific Notice by ID

Scenario: You want the full record of a known notice with ID 123456 to see original or supporting documents.

  • https://lumendatabase.org/notices/123456.json: Fetches the entire notice #123456 in JSON format, including structured attributes (e.g., works, infringing_urls, etc.).

8. Filtering by “Safe Harbor” or “Court Order”

Scenario: You want all the Court Orders posted this year, focusing on possibly sealed or partially redacted legal documents.

  • topic_facet=Court%20Order: Show notices labeled “Court Order.”

  • date_received_facet=1672531200000..1704067200000: From Jan 1, 2023, to Jan 1, 2024.

A Note on Parsing Results

All responses return JSON with a structure like:

You can iterate through pages by appending &page=2, &page=3, and so on to gather additional matches. If you plan to store or display the results, consider normalizing them in a spreadsheet or database for further analysis.

Cost

API access is free for research purposes; tokens are issued on request to the Lumen team and use is governed by the API Terms of Use.

Level of difficulty

starstar

Beginner-Friendly (Web Search) to Moderate (API Research)

  • Basic searching requires only a web browser and minimal familiarity with search filters.

  • API usage or large-scale analysis requires intermediate data-handling or scripting skills (JSON, command line, etc.).

Requirements

  • Website Usage: Public browsing and search will usually be enough for finding notices, but full URLs may be limited. Non-researchers can request one-time, 24-hour access to one full notice per email address.

  • API Usage: Automated searches and notice-data requests require an authentication token, a code that authorizes API requests. Lumen generally issues researcher credentials only to individuals or nonprofit organizations planning journalistic, academic, legal, or policy-focused public research outputs, and may deny or revoke API access.

Limitations

  • Coverage depends on participating submitters and can change. Lumen’s notice-basics page lists Google, Cloudflare, Medium, Meta, the University of California, Vimeo, and Wikipedia/Wikimedia without a pause note; it marks YouTube, Twitter/X, Automattic/WordPress, GitHub, Reddit, and Stack Exchange as not currently sending, no longer sending, or paused.

  • Redacted Fields: Personally identifying information and some notice text may be redacted.

  • Public users may see URLs truncated to the top-level domain, and some sensitive URLs are available only to affiliated researchers.

  • No Bulk Export via Website: For large-scale or automated retrieval, use the API and expect access controls.

  • Date & Result Limits: Large or unfiltered searches can hit the 10,000-result cap; narrow searches by date or another filter. Lumen says the database grows by more than 200,000 notices per week.

  • No Guarantee of Accuracy: Lumen does not confirm or endorse the validity of a notice, and some notices may be fraudulent, abusive, or inaccurate.

  • Google-specific redactions: Google omits some sender names and other details from defamation notices, so those fields may appear as “Redacted”.

Ethical Considerations

  • Potential Privacy Risks: Notices sometimes include sensitive info (names, allegations, etc.). Even though Lumen redacts personal data, some details may still appear in the body or attachments. Handle carefully.

  • Possibility of Misuse: Some takedown requests are abusive or ‘fake DMCA’ attempts, aiming to silence speech or censor legitimate content.

  • Caution with Publication: If you cite Lumen notices, consider verifying with additional sources. A notice alone is not proof of wrongdoing or infringement. Treat notices as leads, not findings. A takedown notice is a claim or request, not proof that the targeted content was unlawful or infringing. Corroborate the parties, dates, URLs, platform action, and legal context before publishing conclusions.

Guides and articles

Official Lumen API documentation – https://berkman-klein-center.gitbook.io/lumen-database/api/documentation seen 2026-06-29.

Steve Vondran: How to track Trump Twitter Takedowns on the lumen database*, Youtube.

*Certain elements of the user interface may have been altered since publishing

Dan Morrill: DMCA notice BPI Part 2 Empty Claims, Youtube.

Tool provider

The Berkman Klein Centre for Internet & Society at Harvard University A research-focused center studying the intersection of law, technology, and society.

Current major contributors (2025): Google Search, YouTube, Meta (Facebook & Instagram), GitHub, Reddit, Wikipedia, Medium, Vimeo, DuckDuckGo, Wordpress, University of California systems. Twitter/X not currently contributing.

Advertising Trackers

Page maintainer

Martin Sona

Last updated

Was this helpful?