Collections

collections#index - get the latest collections

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

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

Body

{
  "collections" : [
    {
      "id" : 127,
      "name" : "Awesome Collection #134",
      "title" : "Best new collection ever",
      "created_at" : "2017-07-13T13:31:52.473-07:00",
      "updated_at" : "2017-07-13T13:31:52.473-07:00",
      "featured_at" : null,
      "subscriber_count" : 0,
      "category_id" : null,
      "collection_url" : "http://www.producthunt.com/@producthunter615/collections/awesome-collection-134?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2364+%28ID%3A+14%29",
      "posts_count" : 0,
      "user" : {
        "id" : 140,
        "created_at" : "2017-07-13T13:31:52.462-07:00",
        "name" : "Karl User the 619th",
        "username" : "producthunter615",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter619",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter615",
        "image_url" : {
          "30px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=30&h=30",
          "32px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=32&h=32",
          "40px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=40&h=40",
          "44px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=44&h=44",
          "48px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=48&h=48",
          "50px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=50&h=50",
          "60px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=60&h=60",
          "64px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "73px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=73&h=73",
          "80px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "88px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "96px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "100px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=100&h=100",
          "110px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=110&h=110",
          "120px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "132px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "146px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=146&h=146",
          "160px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=160&h=160",
          "176px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "220px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=220&h=220",
          "264px" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "32px@2X" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "40px@2X" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "44px@2X" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "88px@2X" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "32px@3X" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "40px@3X" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "44px@3X" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "88px@3X" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "original" : "https://avatars-cdn.producthunt.com/140/original?auto=format&fit=crop&crop=faces&w=original&h=original"
        }
      },
      "background_image_url" : null,
      "color" : "blue"
    },
    {
      "id" : 126,
      "name" : "Awesome Collection #133",
      "title" : "Best new collection ever",
      "created_at" : "2017-07-13T13:31:52.453-07:00",
      "updated_at" : "2017-07-13T13:31:52.453-07:00",
      "featured_at" : null,
      "subscriber_count" : 0,
      "category_id" : null,
      "collection_url" : "http://www.producthunt.com/@producthunter614/collections/awesome-collection-133?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2364+%28ID%3A+14%29",
      "posts_count" : 0,
      "user" : {
        "id" : 139,
        "created_at" : "2017-07-13T13:31:52.443-07:00",
        "name" : "Karl User the 618th",
        "username" : "producthunter614",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter618",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter614",
        "image_url" : {
          "30px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=30&h=30",
          "32px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=32&h=32",
          "40px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=40&h=40",
          "44px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=44&h=44",
          "48px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=48&h=48",
          "50px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=50&h=50",
          "60px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=60&h=60",
          "64px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "73px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=73&h=73",
          "80px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "88px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "96px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "100px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=100&h=100",
          "110px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=110&h=110",
          "120px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "132px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "146px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=146&h=146",
          "160px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=160&h=160",
          "176px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "220px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=220&h=220",
          "264px" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "32px@2X" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "40px@2X" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "44px@2X" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "88px@2X" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "32px@3X" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "40px@3X" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "44px@3X" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "88px@3X" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "original" : "https://avatars-cdn.producthunt.com/139/original?auto=format&fit=crop&crop=faces&w=original&h=original"
        }
      },
      "background_image_url" : null,
      "color" : "blue"
    },
    {
      "id" : 125,
      "name" : "Awesome Collection #132",
      "title" : "Best new collection ever",
      "created_at" : "2017-07-13T13:31:52.433-07:00",
      "updated_at" : "2017-07-13T13:31:52.433-07:00",
      "featured_at" : null,
      "subscriber_count" : 0,
      "category_id" : null,
      "collection_url" : "http://www.producthunt.com/@producthunter613/collections/awesome-collection-132?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2364+%28ID%3A+14%29",
      "posts_count" : 0,
      "user" : {
        "id" : 138,
        "created_at" : "2017-07-13T13:31:52.422-07:00",
        "name" : "Karl User the 617th",
        "username" : "producthunter613",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter617",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter613",
        "image_url" : {
          "30px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=30&h=30",
          "32px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=32&h=32",
          "40px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=40&h=40",
          "44px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=44&h=44",
          "48px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=48&h=48",
          "50px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=50&h=50",
          "60px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=60&h=60",
          "64px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "73px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=73&h=73",
          "80px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "88px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "96px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "100px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=100&h=100",
          "110px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=110&h=110",
          "120px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "132px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "146px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=146&h=146",
          "160px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=160&h=160",
          "176px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "220px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=220&h=220",
          "264px" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "32px@2X" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "40px@2X" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "44px@2X" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "88px@2X" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "32px@3X" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "40px@3X" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "44px@3X" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "88px@3X" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "original" : "https://avatars-cdn.producthunt.com/138/original?auto=format&fit=crop&crop=faces&w=original&h=original"
        }
      },
      "background_image_url" : null,
      "color" : "blue"
    }
  ]
}