Hacker News Keyword Search
Find public Hacker News stories by keyword and publication period, ordered by relevance, date or points.
Aperçu
Collect public technology stories in a table that connects each topic to the stories discussing it. Titles, publication dates, article links and discussion activity help distinguish a widely discussed announcement from a result that merely mentions the same words.
The results bring topic discovery and community response together. They give researchers a starting set of reading material and give product teams context about which stories attracted attention, without requiring them to copy story details and engagement figures individually.
Data notes
Results come from a searchable index of public Hacker News submissions. Relevance ordering prioritizes search matches; chronological ordering compares publication times; hottest ordering compares points and then comment counts within a relevance-selected set of matching stories. Each row belongs to a keyword and a story. The same story can appear for different keywords, which preserves the relationship between a topic and its matches. Match ID stays stable for the same trimmed keyword and story; Story ID identifies the underlying story across topics.
Points and Comments reflect the values returned when collected and can change between runs. They describe accumulated discussion activity, rather than readership, product adoption or sentiment. Hottest results are not a complete popularity ranking of every matching submission and do not represent a time-decayed trending score. Published at refers to the submission's publication time in UTC, rather than the time an article was originally written. Calendar-date boundaries include the entire selected UTC days, while rolling periods are measured backward from the same run-start instant for every keyword. A missing count is represented by zero, and missing text by an empty value.
Article URL may be empty for a submission that consists of a question or discussion. Discussion URL still identifies its conversation. Story text contains the submission body when available, with formatting removed; it does not contain the linked article or individual comments. Search results are a selected view of matching submissions and do not establish that every relevant historical story has been included.
What the results look like
Each record represents one story matching one keyword; these sample activity figures can change over time.
| Keyword | Story ID | Title | Points | Comments | Published at |
|---|---|---|---|---|---|
| python | 45751400 | Uv is the best thing to happen to the Python ecosystem in a decade | 2214 | 1324 | 2025-10-29T18:57:29Z |
| python | 20915746 | Sunsetting Python 2 | 1616 | 704 | 2019-09-09T06:43:24Z |
Other columns include Article URL, Discussion URL, Author, Match ID and Story text.
Use cases
- Prioritize reading: compare Title, Points and Comments to choose stories for closer review, then use Discussion URL to inspect the conversation.
- Compare topics: group results by Keyword and compare the distribution of Points and Comments to understand the activity around the returned stories, while accounting for overlaps using Story ID.
- Trace a topic over time: use Published at and Title to compare early discussions with later announcements; combine Story ID and Match ID to update repeated collections without duplicating the same topic-story pair.
Périmètre et limites
Public stories only, up to 20 keywords and 1,000 returned stories per keyword; hottest ranks at most 1,000 relevance-selected candidates, and search availability may return fewer matches.
- Adapté pour
- Find stories about technologies, products or companies discussed by developers.
- Collect comparable topic results with publication dates and discussion activity.
- Compare recent coverage with earlier stories or examine topic activity within a publication period.
- À ne pas utiliser pour
- You need comment bodies, complete linked articles, or exhaustive historical coverage.
- You need current front-page rank, a time-decayed trending score, or guaranteed highest scores across every matching story.
Gestion des échecs
Comportement en cas d'échec et de nouvelle tentative déclaré par le développeur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.
- 1For an empty result, try a broader or differently worded keyword; an empty result is valid.
- 2If search is temporarily unavailable or rate limited, retry later; earlier returned rows may remain after a failure.
- 3If the run times out, reduce the number of keywords or the per-keyword limit and retry.
- 4Repeated identical keywords are trimmed and processed once; use a list containing one string for a single search.
- 5Use valid YYYY-MM-DD dates with the start on or before the end; periods with no overlap return no stories.
- 6If oldest-first search is too broad, use a narrower publication period or more specific keywords.
Entrée
Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.
- Keywords
keywordsRequisarray<string>Search each string independently. Supply 1 to 20 non-empty strings; repeated identical keywords are processed once.Nombrejusqu'à 20 élémentsExemple["python"] - Limit per keyword
limit_per_keywordFacultatifintegerMaximum stories returned for each keyword, from 1 to 1,000; defaults to 100. Searches with fewer available matches return fewer stories.Plage1–1000Défaut100 - Sort order
sort_byFacultatifstring(enum)Choose how stories are ordered; defaults to relevance. Hottest sorts up to 1,000 relevance-selected matches by points, then comments, and does not guarantee the highest score across all matches.Valeurs possiblesMost relevantrelevanceNewest firstnewestOldest firstoldestHottest (points, then comments)hottestDéfautrelevance - Time range
time_rangeFacultatifstring(enum)Restrict publication time to a rolling period ending at run start; defaults to all time. If custom dates are also supplied, only the overlapping period is searched.Valeurs possiblesAll timeallPast 24 hourslast_24hPast 7 dayslast_7dPast 30 dayslast_30dPast 365 dayslast_yearDéfautall - Custom date range
date_rangeFacultatifobjectOptionally restrict publication time by UTC calendar dates, including both boundary days. Missing dates leave that side open; combined with Time range, only the overlap is searched.
Sortie
Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.
- Match ID
idstringStable identifier for the exact trimmed keyword and story pair.Exemple759cbfc402d5206e48b00a01788e8f5af14e87a83916eb4f340586d316485a0e - Keyword
keywordstringThe trimmed search string that matched this story.Exemplepython - Story ID
story_idstringHacker News story identifier, shared across matching keywords.Exemple45751400 - Title
titlestringStory title; empty when unavailable.ExempleUv is the best thing to happen to the Python ecosystem in a decade
Exemple de données
Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.
{
"id": "759cbfc402d5206e48b00a01788e8f5af14e87a83916eb4f340586d316485a0e",
"keyword": "python",
"story_id": "45751400",
"title": "Uv is the best thing to happen to the Python ecosystem in a decade",
"url": "https://emily.space/posts/251023-uv",
"hn_url": "https://news.ycombinator.com/item?id=45751400",
"author": "todsacerdoti",
"points": 2214,
"num_comments": 1324,
"created_at": "2025-10-29T18:57:29Z",
"story_text": "<story_text>"
}Intégration
Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt. Cette App s'exécute de manière asynchrone et peut être annulée en cours de route : Après l'annulation, l'exécution s'arrête. Les enregistrements déjà livrés sont conservés et facturés.
Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.
Config du client
Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=donglichun/hacker-news-keyword-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Laissez l'IA tout configurer pour vous
Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Par défaut, il vous guide pour vous connecter et ne vous demande jamais d'envoyer votre API Key dans la conversation.)
detail.access.mcp.composeHint
Tarifs
Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées.
Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.
Voir les créditsEssayer maintenant
Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.