--- title: "Semanto: your website as a signed copy for AI agents - Trooth" description: "What Semanto serves, the public routes on api.trooth.co, the headers on every answer, what happens when Trooth is slow, and an install guide for each host." canonical_url: "https://trooth.co/docs/semanto" markdown_url: "https://trooth.co/docs/semanto.md" generated_from: "the rendered page, converted to Markdown when this was requested" agent_index: "https://trooth.co/llms.txt" --- # Semanto Semanto is your website as one signed, machine-readable copy that AI agents can read and check. Trooth hosts it on api.trooth.co. An adapter on your site can serve the same bytes from your own domain, so an agent that asks your site for markdown gets the signed copy. ## The public routes Every route is a plain GET on https://api.trooth.co. Replace trooth_id with the company's Trooth ID. None needs an account. - `/public/semanto/trooth_id` The Semanto file: the company's facts, pages, documents and products, signed by the company and countersigned by Trooth. - `/public/semanto/trooth_id/keys.json` The company's public keys, to check the signatures. - `/public/semanto/trooth_id/facts.jsonld` The company's facts as schema.org JSON-LD. - `/public/semanto/trooth_id/llms.txt` An llms.txt index of the signed pages, and the full text in one file. - `/public/semanto/trooth_id/sitemap.md` A markdown sitemap of the signed pages. - `/public/semanto/trooth_id/pages/page_id.md` One page's signed markdown, by its page ID. - `/public/semanto/trooth_id/by-path/path` One page's signed markdown, or its JSON-LD, by its path on the company's domain. - `/public/semanto/trooth_id/versions` Every signed version, newest first. - `/public/semanto/verify` Checks a copy against the signed version and says what matches. - `/public/semanto/log/checkpoint` The transparency log every signed version is entered in, with its checkpoint. - `/public/semanto/benchmarks` Reads across the network for the last 30 days, by reader and format, with any cell under 20 companies left out. Free to reuse under CC BY 4.0. ## Headers on every answer Each answer carries Content-Digest and an RFC 9421 Signature with Signature-Input, valid for about an hour, plus Trooth-Semanto-Version and Trooth-Page-Hash so a reader can tie the bytes to the signed version. Cache-Control says how long a copy may be kept, and Vary: Accept is on every answer. ## If Trooth is slow or down An adapter never takes your site down. It waits at most 1.5 seconds for a file, uses a stored manifest at once, and when Trooth is slow, unreachable or answers with a server error it serves the last good copy while its signature is valid, the same copy without its signature after that, or your own page. After three failures in 30 seconds it stops asking for 30 seconds. Every answer says where its bytes came from in Trooth-Delivery: trooth, stale, stale-unsigned or host. ## Put it on your site Pick your host. Each guide is a few steps, and the dashboard checks the result for you. - [Open the Cloudflare guide](https://trooth.co/docs/semanto/install/cloudflare-worker) - [Open the Vercel guide](https://trooth.co/docs/semanto/install/vercel-middleware) - [Open the Netlify guide](https://trooth.co/docs/semanto/install/netlify-edge) - [Open the Fastly guide](https://trooth.co/docs/semanto/install/fastly-compute) - [Open the Akamai guide](https://trooth.co/docs/semanto/install/akamai-edgeworkers) - [Open the Gcore guide](https://trooth.co/docs/semanto/install/gcore-fastedge) - [Open the nginx guide](https://trooth.co/docs/semanto/install/nginx-config) - [Open the Apache guide](https://trooth.co/docs/semanto/install/apache-config) - [Open the WordPress guide](https://trooth.co/docs/semanto/install/wordpress-plugin) - [Open the Shopify guide](https://trooth.co/docs/semanto/install/shopify-app) - [Open the Webflow guide](https://trooth.co/docs/semanto/install/webflow-head-code) - [Open the Squarespace guide](https://trooth.co/docs/semanto/install/squarespace-code-injection) - [Open the Wix guide](https://trooth.co/docs/semanto/install/wix-custom-code) - [Open the Any other host guide](https://trooth.co/docs/semanto/install/head-tag) ## Was this page helpful? ## Structured data ```json { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://trooth.co/#org", "name": "Trooth", "legalName": "Trooth, LLC", "alternateName": [ "Trooth, LLC", "Trooth Network", "trooth.co" ], "url": "https://trooth.co", "logo": { "@type": "ImageObject", "@id": "https://trooth.co/#logo", "url": "https://trooth.co/brand/trooth-mark_black-on-white_1024.png", "contentUrl": "https://trooth.co/brand/trooth-mark_black-on-white_1024.png", "width": 1024, "height": 1024, "caption": "Trooth" }, "image": { "@id": "https://trooth.co/#logo" }, "description": "Trooth is an infrastructure and cybersecurity company providing Machine-Readable Trust. The Trooth Network keeps one current Machine-Readable Trust Profile per company, each fact sourced. Trooth signs what it witnessed; company declarations are unsigned.", "foundingDate": "2025-12-16", "address": { "@type": "PostalAddress", "streetAddress": "777 Brickell Ave, Suite 500, PMB 1174", "addressLocality": "Miami", "addressRegion": "FL", "postalCode": "33131", "addressCountry": "US" }, "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "email": "hello@trooth.co", "url": "https://trooth.co/contact" }, "sameAs": [ "https://x.com/Troothllc", "https://github.com/troothllc", "https://www.crunchbase.com/organization/trooth", "https://www.wikidata.org/wiki/Q141292994", "https://www.youtube.com/@Troothllc", "https://www.trustpilot.com/review/trooth.co" ] }, { "@type": "WebSite", "@id": "https://trooth.co/#website", "url": "https://trooth.co", "name": "Trooth", "alternateName": "Trooth Network", "inLanguage": "en", "publisher": { "@id": "https://trooth.co/#org" }, "sameAs": [ "https://trooth.co/network/company/trooth" ], "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://trooth.co/network?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@type": "ItemList", "@id": "https://trooth.co/#sitelinks", "name": "Trooth sitelinks", "itemListElement": [ { "@type": "SiteNavigationElement", "position": 1, "name": "Join Trooth for free", "url": "https://trooth.co/signup" }, { "@type": "SiteNavigationElement", "position": 2, "name": "Company, Trooth", "url": "https://trooth.co/network/company/trooth" }, { "@type": "SiteNavigationElement", "position": 3, "name": "Trooth Network", "url": "https://trooth.co/network" } ] } ] } ```