What is Terra Cotta?

Terra Cotta is Ceramic's web crawler that indexes public content to power their web-scale search API for AI and LLMs. You can set up Agent Analytics to see when Terra Cotta visits your website.

Overview

Operated By Ceramic
Source Official Website
Expected To Follow Robots.txt Yes
Insights Last Updated September 17, 2026

Do you operate this agent? Contact us to suggest an update.

Category

AI Data Provider
Crawls websites to supply structured content to AI systems as a third-party service

Expected Behavior

Terra Cotta supports several kinds of automated activity, so its traffic pattern depends on the task. It may perform broad crawls to collect content or build an index, make targeted requests for specific pages, or shift between these behaviors as demand changes.

Terra Cotta's User Agent

User Agent Terra Cotta 0.1 https://www.github.com/ceramicTeam/CeramicTerracotta

How To Block Terra Cotta With Robots.txt

Add this rule to your robots.txt file to block Terra Cotta from accessing your website, or use Automatic Robots.txt to block all AI data providers at once. You can customize which pages are blocked by swapping out / for a different path.

User-agent: Terra Cotta # https://knownagents.com/agents/terra-cotta
Disallow: /

Insights for Terra Cotta

As of September 17, 2026, this data reflects agent visits measured across thousands of websites using Agent Analytics, combined with daily scans of the top 1000 websites and their robots.txt files.

Robots.txt Blocked Percentage

7%
7% of top websites are blocking Terra Cotta
Learn How →

Country of Origin

United States
Terra Cotta normally visits From the United States

Robots.txt Blocking Trend

7% of top websites block Terra Cotta in their robots.txts.

Overall AI Data Provider Traffic

0.5% of all web traffic came from AI data providers.

Top Visited Website Categories

Books and Literature
Real Estate
Internet and Telecom
Arts and Entertainment
People and Society

The types of websites most frequently visited by Terra Cotta.

Frequently Asked Questions

Should I Block Terra Cotta?

It depends on which uses you want to support. Terra Cotta may supply your content to enterprises, including AI companies, or use it in consumer-facing products. Those uses can include AI training, search, and retrieval. Allowing it may expand your visibility across those products and services, while blocking it limits that reach without affecting traditional search rankings. For context, 7% of the top websites we track currently have robots.txt rules for Terra Cotta.


Does Terra Cotta Follow Robots.txt Rules?

Yes. Terra Cotta is expected to follow robots.txt rules, so a disallow rule is the appropriate first step. Automatic Robots.txt can add and maintain that rule, while Agent Analytics lets you verify whether Terra Cotta respects it.


Does Terra Cotta Access Private Content?

No special access. Terra Cotta can reach public pages, and some providers use proxy networks that can bypass rate limits or geographic restrictions. Protect sensitive content with authentication rather than relying on those softer barriers.


How Can I Tell if Terra Cotta Is Visiting My Website?

Agent Analytics tracks Terra Cotta visits in real time. You can also check your server logs for requests whose user-agent string contains "Terra Cotta". Traffic may range from long crawl sequences across your site to isolated requests for specific pages, depending on whether it is collecting, indexing, or fetching content on demand. Because Terra Cotta does not publish a verification method, any client can claim its identity and a log match is only a clue.


Why Is Terra Cotta Visiting My Website?

One of Ceramic's customers may have requested data from your site, or your pages may be part of Terra Cotta's standing index. A single fetch can support multiple downstream applications.