urlhub for developers and AI

urlhub works without clicking too: build a link to a set, read a set as Markdown or JSON, make a short link. No account and no API key.

A link to a set

Just build the address: links separated by spaces in the urls parameter (encoded as in any address), the language in lang (en or pl), and view=tiles for pictures (the table is the default). Up to 200 links. Send this address as it is: it opens the set in a browser. It never expires, as the whole list is in it.

https://urlhub.cloud/?urls=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FMars%20https%3A%2F%2Fgithub.com%2Fsveltejs%2Fkit&lang=en

A set as text

Add format=md (Markdown) or format=json to the address of any set: a list in the address, a short link /c/, a published page /l/ or a featured set /s/. curl and HTTP libraries get Markdown without asking. Short links and lists in the address read the first 50 links.

curl "https://urlhub.cloud/?urls=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FMars%20https%3A%2F%2Fgithub.com%2Fsveltejs%2Fkit&lang=en"
curl "https://urlhub.cloud/?urls=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FMars%20https%3A%2F%2Fgithub.com%2Fsveltejs%2Fkit&lang=en&format=json"
curl https://urlhub.cloud/c/<id>
https://urlhub.cloud/l/<id>?format=md

A short link

POST a list of links to /api/collections and get a short link /c/<id>. The same list always gets the same link; at most 10 a minute from one address; a link nobody opens for 90 days goes away.

curl -X POST https://urlhub.cloud/api/collections \
  -H 'Content-Type: application/json' \
  -d '{"urls": ["https://en.wikipedia.org/wiki/Mars"], "lang": "en"}'
# {"id": "…", "path": "/c/…"}

QR code

The browser makes the QR code in the Share dialog (of a short link or a published page, to download as PNG or SVG). So it is enough to give someone the link to a set: they make the code themselves.

Limits and rules

No accounts, cookies or analytics tools. Anyone with a link sees the links of its set, so do not put private links in one. Lists in addresses and short links stay out of search results. Too many requests from one address get a 429: try again in a minute.

Files for AI and tools

  • /llms.txt – urlhub described for language models (llms.txt)
  • /openapi.json – the API as OpenAPI 3.1, e.g. for GPT actions and agents