Live demo
No API key is used; unauthenticated requests are rate-limited to 30 per minute per IP. SFW filtering is on by default. Full parameter reference in the API documentation.
How this works: API calls behind this demo
The curl command above updates live as you switch tabs and run queries. The Raw JSON tab shows the full response. Here are all six endpoints this demo covers.
Natural language search
curl "https://lagoon.io/api/v1/search?nl=two+girls+on+twitter+last+3+months&limit=8"
The nl param extracts platform, artist, date range, tags, rating, and sort from plain English. The response includes a filters object showing how the query was parsed.
Semantic similarity
curl "https://lagoon.io/api/v1/similar?q=girl+with+sword+in+the+rain&limit=6"
Text is encoded into a vector at request time and matched against post embeddings by cosine similarity. Also accepts id (post ID) instead of q.
Artist lookup
curl "https://lagoon.io/api/v1/artist?handle=hews__"
Returns cross-platform linked accounts, display names, profile URLs, and indexed post count.
Tag index
curl "https://lagoon.io/api/v1/tags?q=miku&limit=12"
Matches anywhere in the tag name (minimum 2 characters). Results sorted by category priority and post count.
Similar artists (requires API key)
curl -H "X-API-Key: YOUR_KEY" \ "https://lagoon.io/api/v1/similar-artists?handle=hews__&limit=8"
Finds artists with similar visual style using pre-computed style vectors. Returns similarity score and cross-platform handles.
Tag co-occurrence (requires API key)
curl -H "X-API-Key: YOUR_KEY" \ "https://lagoon.io/api/v1/co-occurrence?tag=genshin_impact&limit=15"
Returns tags that frequently co-occur, ranked by count, with Jaccard similarity scores.
Full parameter reference: API documentation.