How each product works

How to use Site Files Checker

What Site Files Checker takes in, which fields it returns and how credits are charged for each lookup.

Last updated 2026-10-22

What it does

Reads the files a site publishes for crawlers, SEO tools and AI agents (robots.txt, its sitemaps, llms.txt, llms-full.txt, security.txt and ai.txt) and explains each one in plain words: present or missing, parse errors and warnings, robots.txt groups and rules with a URL tester, which known AI crawlers are allowed, sitemap URL counts and families, sitemap URLs that robots.txt blocks, llms.txt structure and security.txt required fields and expiry. A checker for site owners and SEOs: it reads only files any visitor can open.

What you send

Send these fields in the JSON body of the request.

No single field is required on its own, but a request with none of them is rejected: Provide url or domain.

Request fields for Site Files Checker
FieldTypeRequiredLimits
urlstringOptionalup to 2,048 characters
domainstringOptionalup to 253 characters
test_urlstringOptionalup to 2,048 characters
user_agentstringOptionalup to 200 characters, fixed format

Request fields for Site Files Checker

What you get back

The data object of a successful response carries these fields. Every response also lists its sources, the credits_charged and whether it was a cache_hit.

Each field is described in the API reference.

Response fields for Site Files Checker
FieldType
sitestring
checked_atstring
overallobject
robotsobject
sitemapsobject
llms_txtobject
llms_full_txtobject
security_txtobject
ai_txtobject
ai_crawlerslist
url_testobject or null

Response fields for Site Files Checker

What it costs

2 credits per site checked (a site that cannot be reached is free).

What each outcome costs
CaseCharge
Found2 credits
Nothing found0 credits
Repeat inside 1 day0 credits
Errors and invalid requests0 credits

What each outcome costs

Run it

You can try it without an account in the free tool. The free tools share a limit per visitor.

From code, send a POST request to https://YOUR_API_HOST/v1/site-files with your API key.

curl -X POST https://YOUR_API_HOST/v1/site-files \
  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"cloudflare.com","test_url":"/cdn-cgi/trace","user_agent":"GPTBot"}'

A request to Site Files Checker

Full parameters and response fields are in the API reference. To run a list of values, use a bulk CSV job.

Good to know

  • A repeat of the same lookup within 1 day is served from your cache and costs 0 credits.
  • When the lookup finds nothing it returns found: false and costs 0 credits.
  • Invalid input and errors are never charged.
  • The API allows 200 requests per 10 seconds per key.

Still stuck? Write to hello@lookvalid.com.