---
title: "GET /hackernews/search"
method: GET
path: "/hackernews/search"
tags: ["HackerNews"]
---

# GET /hackernews/search

`GET /hackernews/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/hackernews/search`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `query` string, required
- `type` 'story' | 'comment'
- `sort` 'relevance' | 'date'
- `page` integer
- `per_page` integer
- `date_from` integer
- `date_to` integer

## Response `200`

- union
  - object
    - `success` boolean, required
    - `data` string, required
    - `meta` object, required
      - `endpoint_family` string, required
      - `billable` boolean, required
  - string

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Hacker News rejected a value in this request. Never charged.
- `500`: Hacker News returned a response shape this parser does not recognise. The incident has been reported; retrying will return the same result.
- `503`: The upstream service is temporarily unavailable. Please retry shortly.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)