Skip to content
GET /v1/tags

All tags

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/lobsters-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/lobsters-api/v1/tags" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/lobsters-api/v1/tags", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/lobsters-api/v1/tags");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/lobsters-api/v1/tags",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "tags": [
            {
                "tag": "ruby",
                "category": "languages",
                "description": "Ruby programming",
                "stories_count": null
            },
            {
                "tag": "event",
                "category": "genre",
                "description": "Events, conferences, and meetups",
                "stories_count": null
            },
            {
                "tag": "person",
                "category": "culture",
                "description": "Stories about particular persons",
                "stories_count": null
            },
            {
                "tag": "meta",
                "category": "lobsters",
                "description": "Lobsters-related bikeshedding - report bugs at https://github.com/lobsters/lobsters",
                "stories_count": null
            },
            {
                "tag": "php",
                "category": "languages",
                "description": "PHP programming",
                "stories_count": null
            },
            {
                "tag": "python",
                "category": "languages",
                "description": "Python programming",
                "stories_count": null
            },
            {
                "tag": "news",
                "category": "genre",
                "description": "General news and current events",
                "stories_count": null
            },
            {
                "tag": "design",
                "category": "interaction",
                "description": "Visual design",
                "stories_count": null
            },
            {
                "tag": "science",
                "category": "field",
                "description": "It's \"Science\"",
                "stories_count": null
            },
            {
                "tag": "video",
                "category": "format",
                "description": "Link to a video",
                "stories_count": null
            },
            {
                "tag": "pdf",
                "category": "format",
                "description": "Link to a PDF document",
                "stories_count": null
            },
            {
                "tag": "lua",
                "category": "languages",
                "description": "Lua programming",
                "stories_count": null
            },
            {
                "tag": "lisp",
                "category": "languages",
                "description": "Lisp and Scheme programming",
                "stories_count": null
            },
            {
                "tag": "javascript",
                "category": "languages",
                "description": "Javascript programming",
                "stories_count": null
            },
            {
                "tag": "vim",
                "category": "tools",
                "description": "Vim editor",
                "stories_count": null
            },
…