Skip to content
GET /v1/tag

Stories filed under a tag

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/tag" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/lobsters-api/v1/tag", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/lobsters-api/v1/tag");
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/tag",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "tag": "web",
        "count": 25,
        "total": 25,
        "stories": [
            {
                "url": "https://forgejo.org/2026-05-monthly-report/",
                "tags": [
                    "vcs",
                    "web"
                ],
                "score": 16,
                "title": "Forgejo monthly report - May 2026",
                "short_id": "ewaxh7",
                "submitter": "FedericoSchonborn",
                "created_at": "2026-06-08T13:41:21.000-05:00",
                "description": null,
                "comments_url": "https://lobste.rs/s/ewaxh7/forgejo_monthly_report_may_2026",
                "lobsters_url": "https://lobste.rs/s/ewaxh7",
                "comment_count": 2
            },
            {
                "url": "https://dbushell.com/2024/04/16/htmx-and-modern-javascript/",
                "tags": [
                    "javascript",
                    "web"
                ],
                "score": 33,
                "title": "HTMX Is So Cool I Rolled My Own (2024)",
                "short_id": "8hiogg",
                "submitter": "FedericoSchonborn",
                "created_at": "2026-06-08T07:20:23.000-05:00",
                "description": null,
                "comments_url": "https://lobste.rs/s/8hiogg/htmx_is_so_cool_i_rolled_my_own_2024",
                "lobsters_url": "https://lobste.rs/s/8hiogg",
                "comment_count": 15
            },
            {
                "url": "https://tangled.org/devins.page/tinysub",
                "tags": [
                    "show",
                    "web"
                ],
                "score": 16,
                "title": "tinysub: full-featured web player for Open Subsonic compatible music servers",
                "short_id": "pfrdqs",
                "submitter": "op",
                "created_at": "2026-06-08T03:55:09.000-05:00",
                "description": null,
                "comments_url": "https://lobste.rs/s/pfrdqs/tinysub_full_featured_web_player_for_open",
                "lobsters_url": "https://lobste.rs/s/pfrdqs",
                "comment_count": 1
            },
            {
                "url": "https://opensource.posit.co/blog/2026-05-21_in-defense-of-yaml/",
                "tags": [
                    "web"
                ],
                "score": 44,
                "title": "In Defense of YAML",
                "short_id": "metnis",
                "submitter": "nrposner",
                "created_at": "2026-06-07T20:36:33.000-05:00",
                "description": null,
                "comments_url": "https://lobste.rs/s/metnis/defense_yaml",
                "lobsters_url": "https://lobste.rs/s/metnis",
                "comment_count": 56
            },
            {
                "url": "https://alexwlchan.net/2026/record-browser-video/",
                "tags": [
                    "javascript",
                    "web"
                ],
                
…