{"id":13502526,"url":"https://github.com/karan/HNify","last_synced_at":"2025-03-29T12:32:06.278Z","repository":{"id":65984351,"uuid":"13947606","full_name":"karan/HNify","owner":"karan","description":"Hacker News REST API using Flask on Heroku using memcached.","archived":false,"fork":false,"pushed_at":"2014-09-01T17:33:30.000Z","size":336,"stargazers_count":91,"open_issues_count":3,"forks_count":11,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-27T02:51:18.434Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://hnify.herokuapp.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/karan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-10-29T05:46:58.000Z","updated_at":"2024-08-05T10:51:19.000Z","dependencies_parsed_at":"2023-02-19T18:10:21.082Z","dependency_job_id":null,"html_url":"https://github.com/karan/HNify","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karan%2FHNify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karan%2FHNify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karan%2FHNify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karan%2FHNify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/karan","download_url":"https://codeload.github.com/karan/HNify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246186817,"owners_count":20737453,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T22:02:16.843Z","updated_at":"2025-03-29T12:32:05.863Z","avatar_url":"https://github.com/karan.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"HNify\n=====\n\n![HNify](https://raw.github.com/karan/HackerNewsAPI/master/HN.jpg)\n\nUnofficial REST API for [Hacker News](https://news.ycombinator.com/). Built using [HackerNewsAPI](https://github.com/karan/HackerNewsAPI).\n\nNow uses memcached for increased performace!\n\nStart\n=====\n\n    $ brew install memcached            # install memcached\n    $ pip install -r requirements.txt   # install dependencies\n    $ memcached -vv                     # start memcached server\n    $ python app.py                     # start the api\n\nDeploy to Heroku\n=====\n\n    $ pip install -r requirements.txt   # install dependencies\n    $ heroku create\n    $ heroku addons:add memcachedcloud\n    $ heroku addons:add newrelic\n    $ (git add, git commit)\n    $ git push heroku master\n\nIf you get an error on the memcached line, see the following [help article](https://devcenter.heroku.com/articles/config-vars).\n\nUsage\n==========\n\n**Base URL:** [http://hnify.herokuapp.com](http://hnify.herokuapp.com)\n\n**Output:** JSON\n\n### Get stories from top page\n\n#### `GET /get/top`\n\n**Parameters:**\n\n| Name | Type | Description |\n| ---- | ---- | ----------- |\n| `limit` | integer | Return only at most these many stories, at least 30 |\n\n### Get stories from newest page\n\n#### `GET /get/newest`\n\n**Parameters:**\n\n| Name | Type | Description |\n| ---- | ---- | ----------- |\n| `limit` | integer | Return only at most these many stories, at least 30 |\n\n### Get stories from best page\n\n#### `GET /get/best`\n\n**Parameters:**\n\n| Name | Type | Description |\n| ---- | ---- | ----------- |\n| `limit` | integer | Return only at most these many stories, at least 30 |\n\n### Currently trending topics on HN\n\n#### `GET /get/trends`\n\n### Get comments from story id\n\n#### `GET /get/comments/\u003cstory_id\u003e/`\n\n--------\n\n### Example\n\n    karan:$ curl -i http://hnify.herokuapp.com/get/newest\n    HTTP/1.1 200 OK\n    Content-Type: application/json\n    Date: Tue, 29 Oct 2013 06:23:39 GMT\n    Server: gunicorn/18.0\n    Content-Length: 16562\n    Connection: keep-alive\n    \n    {\n      \"stories\": [\n        {\n          \"comments_link\": \"http://news.ycombinator.com/item?id=6632337\", \n          \"domain\": \"independent.co.uk\", \n          \"is_self\": false, \n          \"link\": \"http://www.independent.co.uk/news/science/lifi-breakthrough-internet-connections-using-light-bulbs-are-250-times-faster-than-broadband-8909320.html\", \n          \"num_comments\": 0, \n          \"points\": 1, \n          \"published_time\": \"1 minute ago\", \n          \"rank\": 1, \n          \"story_id\": 6632337, \n          \"submitter\": \"yapcguy\", \n          \"submitter_profile\": \"http://news.ycombinator.com/user?id=yapcguy\", \n          \"title\": \"Li-Fi: Internet connections using light bulbs are 250 x faster than broadband\"\n        }, \n        {\n          \"comments_link\": \"http://news.ycombinator.com/item?id=6632335\", \n          \"domain\": \"github.com\", \n          \"is_self\": false, \n          \"link\": \"https://github.com/postmodern/chruby\", \n          \"num_comments\": 0, \n          \"points\": 2, \n          \"published_time\": \"1 minute ago\", \n          \"rank\": 2, \n          \"story_id\": 6632335, \n          \"submitter\": \"michaelrkn\", \n          \"submitter_profile\": \"http://news.ycombinator.com/user?id=michaelrkn\", \n          \"title\": \"Chruby: a lightweight, elegant RVM alternative\"\n        }, \n        \u003c-- snip --\u003e\n        ]\n    }\n\n\nDonations\n=============\n\nIf HNify has helped you in any way, and you'd like to help the developer, please consider donating.\n\n**- BTC: [19dLDL4ax7xRmMiGDAbkizh6WA6Yei2zP5](http://i.imgur.com/bAQgKLN.png)**\n\n**- Gittip: [https://www.gittip.com/karan/](https://www.gittip.com/karan/)**\n\n**- Flattr: [https://flattr.com/profile/thekarangoel](https://flattr.com/profile/thekarangoel)**\n\n\nContribute\n========\n\nIf you want to add any new features, or improve existing ones, feel free to send a pull request!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaran%2FHNify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaran%2FHNify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaran%2FHNify/lists"}