Collections

collections#index - keyset pagination (faster & recommended)

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[featured] Only return collections that have been featured on Product Hunt. true or false. Default = false.
search[category] Only return collections from certain category. Default = unspecified (All categories)
search[slug] Filter by the url slug of the collection
search[user_username] Filter by the username of the creator of the collection
search[subscriber_id] Filter by subscribers of collections

Request

Route

GET /v1/collections?newer=129

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: "9b4389851a15d8700ed3ad3a8e40f762"
Content-Type: application/json; charset=utf-8
Cache-Control: max-age=0, private, must-revalidate
Content-Length: 3877

Body

{
  "collections" : [
    {
      "id" : 130,
      "name" : "Awesome Collection #137",
      "title" : "Best new collection ever",
      "created_at" : "2017-07-13T13:31:52.681-07:00",
      "updated_at" : "2017-07-13T13:31:52.681-07:00",
      "featured_at" : null,
      "subscriber_count" : 0,
      "category_id" : null,
      "collection_url" : "http://www.producthunt.com/@producthunter619/collections/awesome-collection-137?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2365+%28ID%3A+15%29",
      "posts_count" : 0,
      "user" : {
        "id" : 144,
        "created_at" : "2017-07-13T13:31:52.668-07:00",
        "name" : "Karl User the 623th",
        "username" : "producthunter619",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter623",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter619",
        "image_url" : {
          "30px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=30&h=30",
          "32px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=32&h=32",
          "40px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=40&h=40",
          "44px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=44&h=44",
          "48px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=48&h=48",
          "50px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=50&h=50",
          "60px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=60&h=60",
          "64px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "73px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=73&h=73",
          "80px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "88px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "96px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "100px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=100&h=100",
          "110px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=110&h=110",
          "120px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "132px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "146px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=146&h=146",
          "160px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=160&h=160",
          "176px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "220px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=220&h=220",
          "264px" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "32px@2X" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "40px@2X" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "44px@2X" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "88px@2X" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "32px@3X" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "40px@3X" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "44px@3X" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "88px@3X" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "original" : "https://avatars-cdn.producthunt.com/144/original?auto=format&fit=crop&crop=faces&w=original&h=original"
        }
      },
      "background_image_url" : null,
      "color" : "blue"
    }
  ]
}