{
  "url": "https://telipot.com/catalog/tasks/hackernews.news.search",
  "id": "hackernews.news.search",
  "name": "Hacker News stories by query, ranked by relevance",
  "provider": {
    "slug": "hackernews",
    "name": "Hacker News"
  },
  "capability": "news.search",
  "platform": "news",
  "kind": "data",
  "tier": "core",
  "identity": "public",
  "identityLabel": "No account",
  "price": {
    "amount": "Free",
    "state": "free",
    "label": "Free",
    "detail": "Free · no account needed",
    "type": "free"
  },
  "providers": 1,
  "retention": "standard",
  "runsOn": "free",
  "live": true,
  "summary": "Search Hacker News stories and comments",
  "method": "GET",
  "path": "/search",
  "host": "https://hn.algolia.com/api/v1",
  "docsUrl": "https://hn.algolia.com/api",
  "auth": {
    "scheme": "public",
    "label": "public · no credential",
    "short": "public"
  },
  "requiredScopes": [],
  "verification": {
    "state": "verified",
    "label": "Verified on 2026-10-05",
    "detail": "We ran a real request and checked the answer. This is a spot check, not a success rate."
  },
  "input": [
    {
      "name": "query",
      "location": "queryParams",
      "type": "string",
      "required": true,
      "constraints": []
    },
    {
      "name": "tags",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [
        "one of \"story\", \"comment\"",
        "default \"story\""
      ]
    },
    {
      "name": "hitsPerPage",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [
        "1 to 50",
        "default 10"
      ]
    }
  ],
  "sampleInput": {
    "query": "agent tools",
    "hitsPerPage": 2
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "examples": [
          "agent tools"
        ]
      },
      "tags": {
        "type": "string",
        "enum": [
          "story",
          "comment"
        ],
        "default": "story"
      },
      "hitsPerPage": {
        "type": "integer",
        "default": 10,
        "minimum": 1,
        "maximum": 50
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "output": [
    {
      "name": "hits",
      "type": "object[]"
    },
    {
      "name": "hitsPerPage",
      "type": "integer"
    },
    {
      "name": "nbHits",
      "type": "integer"
    },
    {
      "name": "nbPages",
      "type": "integer"
    },
    {
      "name": "page",
      "type": "integer"
    },
    {
      "name": "params",
      "type": "string"
    },
    {
      "name": "processingTimeMS",
      "type": "integer"
    },
    {
      "name": "query",
      "type": "string"
    }
  ],
  "outputSchema": {
    "type": "object",
    "required": [
      "hits",
      "hitsPerPage",
      "nbHits",
      "nbPages",
      "page",
      "query"
    ],
    "properties": {
      "hits": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "objectID",
            "author",
            "created_at",
            "created_at_i",
            "_tags"
          ],
          "properties": {
            "objectID": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "url": {
              "type": "string"
            },
            "author": {
              "type": "string"
            },
            "points": {
              "type": [
                "integer",
                "null"
              ]
            },
            "num_comments": {
              "type": [
                "integer",
                "null"
              ]
            },
            "story_id": {
              "type": "integer"
            },
            "story_text": {
              "type": "string"
            },
            "comment_text": {
              "type": "string"
            },
            "created_at": {
              "type": "string"
            },
            "created_at_i": {
              "type": "integer"
            },
            "updated_at": {
              "type": "string"
            },
            "_tags": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      },
      "hitsPerPage": {
        "type": "integer"
      },
      "nbHits": {
        "type": "integer"
      },
      "nbPages": {
        "type": "integer"
      },
      "page": {
        "type": "integer"
      },
      "params": {
        "type": "string"
      },
      "processingTimeMS": {
        "type": "integer"
      },
      "query": {
        "type": "string"
      }
    }
  },
  "example": {
    "file": "examples/hackernews.news.search.json",
    "json": {
      "hits": [
        {
          "_tags": [
            "story",
            "author_user"
          ],
          "author": "user",
          "created_at": "2026-07-09T15:45:17Z",
          "created_at_i": 1783611917,
          "num_comments": 40,
          "objectID": "48847834",
          "points": 96,
          "story_id": 48847834,
          "story_text": "Hey HN! We built a browser-based agent that runs inside an authenticated web app, watches how the app calls its own APIs, and automatically turns those into agent tools. You can think of it as an auto…",
          "title": "Show HN: Reverse-engineering web apps into agent tools",
          "updated_at": "2026-07-20T14:39:08Z"
        },
        {
          "_tags": [
            "story",
            "author_user"
          ],
          "author": "user",
          "created_at": "2026-03-24T06:31:15Z",
          "created_at_i": 1774333875,
          "num_comments": 8,
          "objectID": "47499242",
          "points": 50,
          "story_id": 47499242,
          "title": "Fast regex search: indexing text for agent tools",
          "updated_at": "2026-04-09T02:11:45Z",
          "url": "https://cursor.com/blog/fast-regex-search"
        }
      ],
      "hitsPerPage": 2,
      "nbHits": 69733,
      "nbPages": 500,
      "page": 0,
      "params": "query=agent+tools&hitsPerPage=2&advancedSyntax=true&analyticsTags=backend",
      "processingTimeMS": 36,
      "query": "agent tools"
    }
  },
  "commands": {
    "mode": "run",
    "cli": "telipot run hackernews.news.search \\\n  --input-json '{\"query\":\"agent tools\",\"hitsPerPage\":2}'",
    "http": "curl https://api.telipot.com/v1/tasks/hackernews.news.search/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\":\"agent tools\",\"hitsPerPage\":2}'",
    "quote": "telipot run hackernews.news.search \\\n  --input-json '{\"query\":\"agent tools\",\"hitsPerPage\":2}' \\\n  --quote"
  },
  "siblings": []
}