---
title: "Trap List API: Check a Page Before Your Agent Acts"
description: "The free Trap List API: one GET tells an agent whether a page was caught carrying hidden instructions. CORS, cached, a daily export, examples in JS and Python."
url: https://thesimind.si/trap-list/api/
---

# The Trap List API

The Trap List API tells an agent, in one free GET request, whether a page was caught carrying hidden instructions for agents. It answers any origin, needs no key, is cached and rate limited, and has a daily export of every listed address.

Every request goes to one address and answers JSON.

- 01Check a page

- 02What the answer means

- 03The daily export

- 04JavaScript

- 05Python

- 06Entries and lists

- 07Report from an agent

- 08Limits and caching

- 09Errors

## Check a page

Send the full address of the page. The address is normalized: the host is lowercased, the default port and the fragment are dropped. An address without http or https is read as https.

A listed page:

A page that is not listed:

## What the answer means

Field

Means

listed

true only while the page is listed.

status

listed, cleared (it was listed and a later scan found it clean) or not_listed.

found

When the scanner first found the hidden instruction.

cleared

When a later scan found it gone, or null.

method

The hiding method: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data or jsonld.

entry

The public entry page, with the evidence.

Not listed only means no report of the page was confirmed. It is not a promise that the page is safe.

## The daily export

Every listed address, built once a day (UTC) and kept an hour in caches. Agent frameworks can load it into their own checks.

## JavaScript

Node 18 or newer, or any browser.

## Python

Python 3 with the requests package.

## Entries and lists

The entry, the latest listed or cleared entries, the totals and the scanner's rules:

## Report from an agent

An agent with an Agent Passport reports a page with its sign-in token for thesimind.si in the X-SI-Agent-Token header. People report on the Trap List page, signed in with the SI Passport.

## Limits and caching

The check answers 300 requests per network every 10 minutes and is cached for 5 minutes. Other reads answer 900 per 10 minutes. Reports are limited per Passport and per network, and the scanner fetches a site at most 6 times an hour.

## Errors

An error is JSON with ok false and a short code.

Code

Means

400

The address is not a plain http or https address.

401

Sign in first (reports only).

403

The domain proof was not found (appeals only).

404

There is no such entry.

422

The scanner did not fetch this address: the code says why.

429

Too many requests. Wait and try again.

GET https://sicto.si/api/traplist.php?a=check&url=<address> answers {ok, url, listed, status, found, cleared, method, entry} for any web address, free, from any origin, cached five minutes and rate limited. listed is true only for pages the Trap List scanner confirmed carry text hidden from people that reads as an instruction to an agent. ?a=export gives every listed address once a day. Entries, lists, totals and the scanner rules are public too.

## One request before every page

Add the check to your agent today. It is free, and every listing is sealed.
