API V1 is deprecated, Check out new API V2 here

Posts

posts#all - get most upvoted posts for a given month

Parameters

Name Description
older Cursor-based pagination: Only works with ID. Get records older than the provided id. Note: Sort_by is ignored and applied afterwards.
newer Cursor-based pagination: Only works with ID. Get records newer than the provided id. Note: Sort_by is ignored and applied afterwards.
page Offset-based pagination: Get content of given page, starts at 1
per_page Any kind of pagination: define the amount of records sent per call (max 50)
sort_by Sort api response: Valid options: id, created_at, updated_at
order Sort api response: valid parameters are desc and asc
search[url] Filter parameter: can filter posts by url
search[category] Filter parameter: can filter posts by category. Default = unspecified (All categories)
search[topic] Filter parameter: can filter posts by topic id or slug. Default = unspecified (All topics)
sort_by Apart of the normal sort_by values you can also use "votes_count" for posts#all
search[featured_year] Filter parameter: can filter posts by year the post got featured
search[featured_month] Filter parameter: can filter posts by month the post got featured
search[featured_day] Filter parameter: can filter posts by day the post got featured

Request

Route

GET /v1/posts/all?sort_by=votes_count&order=desc&search[featured_month]=5&search[featured_year]=2017

Headers

Accept: application/json
Content-Type: application/json
Authorization: Bearer your_access_token-syuWwzj7zeHABQIXUYhI1dKdYzGNJUS6Xk
Host: api.producthunt.com

Response

Status

200 OK

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Rate-Limit-Limit: 900
X-Rate-Limit-Remaining: 900
X-Rate-Limit-Reset: 900
ETag: W/"00db07029511d50c6ca568e52ca4481f"
Last-Modified: Wed, 05 May 2021 11:39:07 GMT
Content-Type: application/json; charset=utf-8
Cache-Control: max-age=0, private, must-revalidate
Content-Length: 11369

Body

{
  "posts": [
    {
      "comments_count": 0,
      "id": 1438,
      "name": "Awesome Idea #29",
      "product_state": "default",
      "tagline": "Great new search engine",
      "slug": "awesome-idea-29",
      "votes_count": 3,
      "day": "2017-05-01",
      "category_id": null,
      "created_at": "2017-05-01T00:00:00.000-07:00",
      "current_user": {},
      "discussion_url": "http://www.producthunt.com/posts/awesome-idea-29?utm_campaign=producthunt-api\u0026utm_medium=api\u0026utm_source=Application%3A+Awesome+Oauth+App+%2321+%28ID%3A+1211%29",
      "exclusive": null,
      "featured": true,
      "ios_featured_at": false,
      "maker_inside": false,
      "makers": [],
      "platforms": [],
      "redirect_url": "http://www.producthunt.com/r/f794d25eaf84d1/1438?app_id=1211",
      "screenshot_url": {
        "300px": "http://placehold.it/850x850.png",
        "850px": "http://placehold.it/850x850.png"
      },
      "thumbnail": {
        "id": 1487,
        "media_type": "image",
        "image_url": "https://ph-files.imgix.net/131621a3-bddb-4dd1-93ac-afd7841266a6?auto=format\u0026fit=crop\u0026h=570\u0026w=430",
        "metadata": {}
      },
      "topics": [],
      "user": {
        "id": 9592,
        "created_at": "2021-05-05T04:39:07.255-07:00",
        "name": "Karl User the 116th",
        "username": "producthunter116",
        "headline": "Product Hunter",
        "twitter_username": "hunter116",
        "website_url": "http://awesome.io",
        "profile_url": "http://www.producthunt.com/@producthunter116",
        "image_url": {
          "30px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "32px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "40px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "44px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "48px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "50px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "60px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "64px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "73px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "80px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "88px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "96px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "100px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "110px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "120px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "132px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "146px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "160px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "176px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "220px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "264px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "32px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "40px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "44px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "88px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "32px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "40px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "44px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "88px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "original": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress"
        }
      }
    },
    {
      "comments_count": 0,
      "id": 1440,
      "name": "Awesome Idea #31",
      "product_state": "default",
      "tagline": "Great new search engine",
      "slug": "awesome-idea-31",
      "votes_count": 2,
      "day": "2017-05-04",
      "category_id": null,
      "created_at": "2017-05-04T00:00:00.000-07:00",
      "current_user": {},
      "discussion_url": "http://www.producthunt.com/posts/awesome-idea-31?utm_campaign=producthunt-api\u0026utm_medium=api\u0026utm_source=Application%3A+Awesome+Oauth+App+%2321+%28ID%3A+1211%29",
      "exclusive": null,
      "featured": true,
      "ios_featured_at": false,
      "maker_inside": false,
      "makers": [],
      "platforms": [],
      "redirect_url": "http://www.producthunt.com/r/48628f4f2c6826/1440?app_id=1211",
      "screenshot_url": {
        "300px": "http://placehold.it/850x850.png",
        "850px": "http://placehold.it/850x850.png"
      },
      "thumbnail": {
        "id": 1489,
        "media_type": "image",
        "image_url": "https://ph-files.imgix.net/b571aec1-ff88-4336-9a8d-613a80a6a532?auto=format\u0026fit=crop\u0026h=570\u0026w=430",
        "metadata": {}
      },
      "topics": [],
      "user": {
        "id": 9602,
        "created_at": "2021-05-05T04:39:07.402-07:00",
        "name": "Karl User the 126th",
        "username": "producthunter126",
        "headline": "Product Hunter",
        "twitter_username": "hunter126",
        "website_url": "http://awesome.io",
        "profile_url": "http://www.producthunt.com/@producthunter126",
        "image_url": {
          "30px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "32px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "40px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "44px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "48px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "50px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "60px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "64px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "73px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "80px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "88px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "96px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "100px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "110px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "120px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "132px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "146px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "160px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "176px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "220px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "264px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "32px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "40px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "44px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "88px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "32px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "40px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "44px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "88px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "original": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress"
        }
      }
    },
    {
      "comments_count": 0,
      "id": 1439,
      "name": "Awesome Idea #30",
      "product_state": "default",
      "tagline": "Great new search engine",
      "slug": "awesome-idea-30",
      "votes_count": 1,
      "day": "2017-05-02",
      "category_id": null,
      "created_at": "2017-05-02T00:00:00.000-07:00",
      "current_user": {},
      "discussion_url": "http://www.producthunt.com/posts/awesome-idea-30?utm_campaign=producthunt-api\u0026utm_medium=api\u0026utm_source=Application%3A+Awesome+Oauth+App+%2321+%28ID%3A+1211%29",
      "exclusive": null,
      "featured": true,
      "ios_featured_at": false,
      "maker_inside": false,
      "makers": [],
      "platforms": [],
      "redirect_url": "http://www.producthunt.com/r/044e062288c1ac/1439?app_id=1211",
      "screenshot_url": {
        "300px": "http://placehold.it/850x850.png",
        "850px": "http://placehold.it/850x850.png"
      },
      "thumbnail": {
        "id": 1488,
        "media_type": "image",
        "image_url": "https://ph-files.imgix.net/e86f340c-88c9-4b07-b544-5d4d7a5ad340?auto=format\u0026fit=crop\u0026h=570\u0026w=430",
        "metadata": {}
      },
      "topics": [],
      "user": {
        "id": 9598,
        "created_at": "2021-05-05T04:39:07.345-07:00",
        "name": "Karl User the 122th",
        "username": "producthunter122",
        "headline": "Product Hunter",
        "twitter_username": "hunter122",
        "website_url": "http://awesome.io",
        "profile_url": "http://www.producthunt.com/@producthunter122",
        "image_url": {
          "30px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "32px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "40px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "44px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "48px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "50px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "60px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "64px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "73px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "80px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "88px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "96px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "100px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "110px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "120px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "132px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "146px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "160px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "176px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "220px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "264px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "32px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "40px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "44px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "88px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "32px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "40px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "44px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "88px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
          "original": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress"
        }
      }
    }
  ]
}