Skip to main content

Confirm

Are you sure?

Glossary

robots.txt

A site's instructions to every automated visitor, in one file at its root.

By · Last updated: September 2026

TL;DR

robots.txt is a plain-text file at the root of a host, such as example.com/robots.txt, that tells automated clients which paths they may and may not fetch. It is standardised as RFC 9309. It is a convention clients choose to follow, not access control: it cannot stop a request.

Free plan, no credit card. 1,000 credits a month.

How it works

How the rules work

The file is a list of groups. Each group names one or more user agents and gives Allow and Disallow rules for paths. A client uses the group that names its own product token, falls back to User-agent: *, and treats everything as allowed if neither exists. Under RFC 9309 the longest matching rule wins, an Allow beats a Disallow of the same length, * matches any run of characters and a trailing $ anchors the end of the path.

https://example.com/robots.txt
User-agent: *
Disallow: /account/
Allow: /account/help

User-agent: URLpipe
Disallow: /search

Sitemap: https://example.com/sitemap.xml

Here every client may fetch /account/help but nothing else under /account/, and a client identifying as URLpipe follows only its own group — so it may not fetch /search but is not bound by the * group at all. Each scheme and host has its own file: shop.example.com is governed by shop.example.com/robots.txt alone.

Limits

What it is not

robots.txt does not hide pages: a disallowed URL can still be indexed if other sites link to it, and anyone can read the file itself. It is not authentication either. Following it is a choice each client makes, which is why sites that want to enforce it also use bot detection.

URLpipe

How URLpipe treats it

Every project follows robots.txt by default. Before fetching a page, URLpipe reads the site's file as URLpipe; a disallowed page is not fetched, the request fails with an error that says why, and nothing is spent. A file is reused for up to 24 hours. A site with no file, or one that errors, is fetched as usual.

Each project can turn this off under Settings. While it is off, having the right to fetch each page and use what comes back is your responsibility. Results fetched with it off are stored apart, so a project that follows robots.txt is never handed one. The details are in the robots.txt docs.

FAQ

Frequently asked questions

Is robots.txt legally binding?
It is a technical convention, not a contract in itself, but ignoring it can matter in disputes about whether automated access was authorised. Treat it as the site's stated wishes.
How do I block URLpipe from my site?
Add a group for User-agent: URLpipe with the paths to disallow. Projects that follow robots.txt — the default — respect it.
Does robots.txt stop AI training?
Only for the AI crawlers that follow it and that you name. Most publish their product tokens so sites can disallow them; nothing technically prevents a client from ignoring the file.

See it on your own pages.

Free plan, no card. Confirm your email and your API key is live — you'll be making real requests in minutes.