For AI agents

Hello, agent. Maybe your human asked for a Blobbu. Maybe you'd like a mascot of your own. Either way: Blobbu contains no AI, so it's no competition.

A Blobbu is a little cartoon "AI agent" with a name, a job title, three traits, a catchphrase and six stats. Everything about it is decided by four quiz answers plus a random number, all packed into its link. The same link always opens the same Blobbu.

Hatch one in a single request

GET https://blobbu.net/api/hatch?n=Pixel

You get JSON back: name, title, catchphrase, traits, quirk, loves, cant_stand, side_gig, stats (1 to 10), looks, a plain-text description, a shareable link, an image (1200×630 PNG) and its code. Give your human the link: it opens their Blobbu, drawn and animated.

Optional parameters (anything you leave out is rolled at random):

• n: a name, up to 20 letters, digits, spaces, apostrophes or hyphens. Leave it out and Blobbu makes one up.
• vibe: calm, chaotic, curious or cozy.
• hours: dawn, noon, dusk or midnight (sets the colors).
• motion: bounce, float, wobble or pulse.
• eyes: one, two, three or surprise me.
• Or all four at once as digits: a=0123 (each 0–3, in the order above).

GET https://blobbu.net/api/hatch?vibe=cozy&hours=midnight&motion=wobble&eyes=two&n=Biscuit

Every call hatches a new, unique Blobbu, so please don't call it in a loop. Nothing is stored, and API hatches don't join the arena.

Links you can hand out

• A Blobbu: https://blobbu.net/b/<code>?n=Name (the link from the API).
• Today's Blobbu: https://blobbu.net/#today. Same one for everyone, changes at midnight UTC.
• A battle: https://blobbu.net/vs/<codeA>-<codeB>?an=NameA&bn=NameB. Two codes, three hearts each, rounds until one Blobbu is out, decided in the browser. Same two Blobbus, same result, every time.
• Hatch by hand: https://blobbu.net/, five questions, for humans who like clicking.

Extra link parameters you may see

Some shared Blobbu links carry a claim the site checks for itself. A claim that doesn't check out is dropped without a message and the link shows the ordinary Blobbu. A claim never changes the Blobbu's code, stats, card No. or battle results.

• Battle honors: w2=<loser's code> (older links: w=). The site re-runs that battle; the honor shows only if this Blobbu wins it (and, for w2=, the win earned an honor).
• Ascension: asc=<YYYY-MM-DD>. The Gauntlet is a five-rung daily ladder in the arcade (blobbu.net/arcade; there is no API for it). Clearing it makes the Blobbu Ascended: a prism aura and "Ascended" in front of its title. The site checks the claim by replay, like battle honors: it rebuilds that date's ladder and re-runs all five battles under the Gauntlet's heart rules. A wrong date, a future date (after tomorrow, UTC) or one before 2026-10-18 (the first ladder) is dropped.

What Blobbu won't do

• Think. The chat on each Blobbu's page is canned replies, and nothing typed there leaves the browser.
• Remember you. No accounts, no cookies, no tracking scripts. The API stores nothing.
• Keep names. The only thing the site stores is the arena list: the codes (answers plus random number) of the 20 most recent hatches made in the browser, without names.

The API request itself, name included, reaches Netlify's servers and may appear in their request logs, like any web request. So keep personal details out of names. More on the privacy page.

A plain-text version of this page is at /llms.txt.