Posts

posts#all - get the latest posts

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

Headers

Accept: application/json
Content-Type: application/json
Authorization: Bearer your_access_token
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: "d6714842b6955960e1ebb59f8e779881"
Content-Type: application/json; charset=utf-8
Cache-Control: max-age=0, private, must-revalidate
Content-Length: 12512

Body

{
  "posts" : [
    {
      "category_id" : 1,
      "comments_count" : 0,
      "day" : "2017-07-13",
      "id" : 3,
      "name" : "Awesome Idea #34",
      "product_state" : "default",
      "tagline" : "Great new search engine",
      "ios_featured_at" : null,
      "created_at" : "2017-07-13T13:31:24.072-07:00",
      "current_user" : {},
      "discussion_url" : "http://www.producthunt.com/posts/awesome-idea-34?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2323+%28ID%3A+1%29",
      "exclusive" : null,
      "featured" : true,
      "maker_inside" : false,
      "makers" : [],
      "platforms" : [],
      "topics" : [],
      "redirect_url" : "http://www.producthunt.com/r/1c8a94b376168c/3?app_id=1",
      "screenshot_url" : {
        "300px" : "http://placehold.it/850x850.png",
        "850px" : "http://placehold.it/850x850.png"
      },
      "thumbnail" : {
        "id" : 3,
        "media_type" : "image",
        "image_url" : "https://ph-files.imgix.net/e974ef02-6381-471c-8f9b-83491f1fbc0d?auto=format&fit=crop&h=570&w=430",
        "metadata" : {}
      },
      "user" : {
        "id" : 7,
        "created_at" : "2017-07-13T13:31:24.037-07:00",
        "name" : "Karl User the 143th",
        "username" : "producthunter143",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter143",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter143",
        "image_url" : {
          "30px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=30&h=30",
          "32px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=32&h=32",
          "40px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=40&h=40",
          "44px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=44&h=44",
          "48px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=48&h=48",
          "50px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=50&h=50",
          "60px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=60&h=60",
          "64px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "73px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=73&h=73",
          "80px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "88px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "96px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "100px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=100&h=100",
          "110px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=110&h=110",
          "120px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "132px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "146px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=146&h=146",
          "160px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=160&h=160",
          "176px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "220px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=220&h=220",
          "264px" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "32px@2X" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "40px@2X" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "44px@2X" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "88px@2X" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "32px@3X" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "40px@3X" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "44px@3X" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "88px@3X" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "original" : "https://avatars-cdn.producthunt.com/7/original?auto=format&fit=crop&crop=faces&w=original&h=original"
        }
      },
      "votes_count" : 0
    },
    {
      "category_id" : 1,
      "comments_count" : 0,
      "day" : "2017-07-13",
      "id" : 2,
      "name" : "Awesome Idea #33",
      "product_state" : "default",
      "tagline" : "Great new search engine",
      "ios_featured_at" : null,
      "created_at" : "2017-07-13T13:31:23.967-07:00",
      "current_user" : {},
      "discussion_url" : "http://www.producthunt.com/posts/awesome-idea-33?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2323+%28ID%3A+1%29",
      "exclusive" : null,
      "featured" : true,
      "maker_inside" : false,
      "makers" : [],
      "platforms" : [],
      "topics" : [],
      "redirect_url" : "http://www.producthunt.com/r/e27b374a5605ef/2?app_id=1",
      "screenshot_url" : {
        "300px" : "http://placehold.it/850x850.png",
        "850px" : "http://placehold.it/850x850.png"
      },
      "thumbnail" : {
        "id" : 2,
        "media_type" : "image",
        "image_url" : "https://ph-files.imgix.net/d2d3d583-fa6e-4f1e-8386-bec669bb5118?auto=format&fit=crop&h=570&w=430",
        "metadata" : {}
      },
      "user" : {
        "id" : 4,
        "created_at" : "2017-07-13T13:31:23.928-07:00",
        "name" : "Karl User the 140th",
        "username" : "producthunter140",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter140",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter140",
        "image_url" : {
          "30px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=30&h=30",
          "32px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=32&h=32",
          "40px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=40&h=40",
          "44px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=44&h=44",
          "48px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=48&h=48",
          "50px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=50&h=50",
          "60px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=60&h=60",
          "64px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "73px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=73&h=73",
          "80px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "88px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "96px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "100px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=100&h=100",
          "110px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=110&h=110",
          "120px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "132px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "146px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=146&h=146",
          "160px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=160&h=160",
          "176px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "220px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=220&h=220",
          "264px" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "32px@2X" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "40px@2X" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "44px@2X" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "88px@2X" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "32px@3X" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "40px@3X" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "44px@3X" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "88px@3X" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "original" : "https://avatars-cdn.producthunt.com/4/original?auto=format&fit=crop&crop=faces&w=original&h=original"
        }
      },
      "votes_count" : 0
    },
    {
      "category_id" : 1,
      "comments_count" : 0,
      "day" : "2017-07-13",
      "id" : 1,
      "name" : "Awesome Idea #32",
      "product_state" : "default",
      "tagline" : "Great new search engine",
      "ios_featured_at" : null,
      "created_at" : "2017-07-13T13:31:23.831-07:00",
      "current_user" : {},
      "discussion_url" : "http://www.producthunt.com/posts/awesome-idea-32?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2323+%28ID%3A+1%29",
      "exclusive" : null,
      "featured" : true,
      "maker_inside" : false,
      "makers" : [],
      "platforms" : [],
      "topics" : [],
      "redirect_url" : "http://www.producthunt.com/r/c9eeff5ccb4857/1?app_id=1",
      "screenshot_url" : {
        "300px" : "http://placehold.it/850x850.png",
        "850px" : "http://placehold.it/850x850.png"
      },
      "thumbnail" : {
        "id" : 1,
        "media_type" : "image",
        "image_url" : "https://ph-files.imgix.net/d36bcf61-ce77-4524-9c9c-694a839853d7?auto=format&fit=crop&h=570&w=430",
        "metadata" : {}
      },
      "user" : {
        "id" : 1,
        "created_at" : "2017-07-13T13:31:23.800-07:00",
        "name" : "Karl User the 137th",
        "username" : "producthunter137",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter137",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter137",
        "image_url" : {
          "30px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=30&h=30",
          "32px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=32&h=32",
          "40px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=40&h=40",
          "44px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=44&h=44",
          "48px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=48&h=48",
          "50px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=50&h=50",
          "60px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=60&h=60",
          "64px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "73px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=73&h=73",
          "80px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "88px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "96px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "100px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=100&h=100",
          "110px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=110&h=110",
          "120px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "132px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "146px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=146&h=146",
          "160px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=160&h=160",
          "176px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "220px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=220&h=220",
          "264px" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "32px@2X" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "40px@2X" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "44px@2X" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "88px@2X" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "32px@3X" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "40px@3X" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "44px@3X" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "88px@3X" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "original" : "https://avatars-cdn.producthunt.com/1/original?auto=format&fit=crop&crop=faces&w=original&h=original"
        }
      },
      "votes_count" : 0
    }
  ]
}