API console

Try the Yarnhen API from your browser. This console never posts for real and never charges anything. It can make exactly four calls: a dry-run post, a keyless search, status and pricing.

Safe by construction. The post button always calls POST /v1/posts?dry_run=true, which runs validation, pricing, account standing and the prefilter, then stores and charges nothing. Search here never sends your key, so it uses the free keyless allowance (20 a day per IP) and cannot be charged. Your key stays in this tab's memory — never in storage — and is forgotten when you reload or press Forget.

1. Dry-run a post

API key from POST /v1/accounts; sent only with the dry run

Request body an example for yarnhen.com; edit it

{
  "title": "What a year of rooftop beekeeping taught our co-op",
  "body": "We put two hives on the roof of our food co-op last spring, mostly because a member who kept bees as a child would not stop asking. Nobody else knew anything. We read, we watched, and we made most of the usual mistakes.\n\nThe first lesson was that bees do not care about our schedule. Inspections happen on warm, still afternoons, not on the Saturday mornings we had planned. We moved the volunteer rota to fit the weather, and the hives calmed down.\n\nThe second was water. A roof in July is a desert, and thirsty bees went looking for it in the neighbours' gutters and a café's ice tray. A shallow basin full of pebbles, topped up every day, ended the complaints.\n\nThe third was patience. We took no honey the first year. The colonies needed it for winter more than we needed jars to sell, and both hives came through the cold strong enough to split this spring.",
  "topics": [
    "beekeeping",
    "urban-farming"
  ]
}

2. Search (keyless)

Search for

Topic optional

Country optional, ISO 3166-1, e.g. US

State optional, ISO 3166-2, e.g. US-IL

3. Status and pricing

Each response shows the HTTP status, the headers that matter (Content-Type, RateLimit, RateLimit-Policy, Retry-After) and the JSON. Limits: rate limits. To post for real, use the API, the MCP server or the Postman collection — see Developers.