Collections

collections#index - Filter by Featured 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?search[featured]=true

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

Body

{
  "collections" : [
    {
      "id" : 104,
      "name" : "Awesome Collection #113",
      "title" : "Best new collection ever",
      "created_at" : "2017-07-13T13:31:51.027-07:00",
      "updated_at" : "2017-07-13T13:31:51.027-07:00",
      "featured_at" : "2017-07-11T13:31:08.421-07:00",
      "subscriber_count" : 0,
      "category_id" : null,
      "collection_url" : "http://www.producthunt.com/@producthunter582/collections/awesome-collection-113?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2354+%28ID%3A+4%29",
      "posts_count" : 0,
      "user" : {
        "id" : 107,
        "created_at" : "2017-07-13T13:31:51.013-07:00",
        "name" : "Karl User the 586th",
        "username" : "producthunter582",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter586",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter582",
        "image_url" : {
          "30px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=30&h=30",
          "32px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=32&h=32",
          "40px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=40&h=40",
          "44px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=44&h=44",
          "48px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=48&h=48",
          "50px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=50&h=50",
          "60px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=60&h=60",
          "64px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "73px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=73&h=73",
          "80px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "88px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "96px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "100px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=100&h=100",
          "110px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=110&h=110",
          "120px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "132px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "146px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=146&h=146",
          "160px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=160&h=160",
          "176px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "220px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=220&h=220",
          "264px" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "32px@2X" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "40px@2X" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "44px@2X" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "88px@2X" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "32px@3X" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "40px@3X" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "44px@3X" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "88px@3X" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "original" : "https://avatars-cdn.producthunt.com/107/original?auto=format&fit=crop&crop=faces&w=original&h=original"
        }
      },
      "background_image_url" : null,
      "color" : "blue"
    },
    {
      "id" : 103,
      "name" : "Awesome Collection #112",
      "title" : "Best new collection ever",
      "created_at" : "2017-07-13T13:31:50.999-07:00",
      "updated_at" : "2017-07-13T13:31:50.999-07:00",
      "featured_at" : "2017-07-11T13:31:08.421-07:00",
      "subscriber_count" : 0,
      "category_id" : null,
      "collection_url" : "http://www.producthunt.com/@producthunter581/collections/awesome-collection-112?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2354+%28ID%3A+4%29",
      "posts_count" : 0,
      "user" : {
        "id" : 106,
        "created_at" : "2017-07-13T13:31:50.987-07:00",
        "name" : "Karl User the 585th",
        "username" : "producthunter581",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter585",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter581",
        "image_url" : {
          "30px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=30&h=30",
          "32px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=32&h=32",
          "40px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=40&h=40",
          "44px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=44&h=44",
          "48px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=48&h=48",
          "50px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=50&h=50",
          "60px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=60&h=60",
          "64px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "73px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=73&h=73",
          "80px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "88px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "96px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "100px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=100&h=100",
          "110px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=110&h=110",
          "120px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "132px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "146px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=146&h=146",
          "160px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=160&h=160",
          "176px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "220px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=220&h=220",
          "264px" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "32px@2X" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=64&h=64",
          "40px@2X" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=80&h=80",
          "44px@2X" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=88&h=88",
          "88px@2X" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=176&h=176",
          "32px@3X" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=96&h=96",
          "40px@3X" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=120&h=120",
          "44px@3X" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=132&h=132",
          "88px@3X" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=264&h=264",
          "original" : "https://avatars-cdn.producthunt.com/106/original?auto=format&fit=crop&crop=faces&w=original&h=original"
        }
      },
      "background_image_url" : null,
      "color" : "blue"
    }
  ]
}