Collections

collections#index - Filter by username and/or slug

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[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[slug]=somecollection&search[user_username]=producthunter605

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

Body

{
  "collections" : [
    {
      "id" : 117,
      "name" : "somecollection",
      "title" : "Best new collection ever",
      "created_at" : "2017-09-14T06:02:30.317-07:00",
      "updated_at" : "2017-09-14T06:02:30.317-07:00",
      "featured_at" : null,
      "subscriber_count" : 0,
      "background_image_url" : null,
      "category_id" : null,
      "collection_url" : "http://www.producthunt.com/@producthunter605/collections/somecollection?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2361+%28ID%3A+11%29",
      "color" : "blue",
      "posts_count" : 0,
      "user" : {
        "id" : 127,
        "created_at" : "2017-09-14T06:02:30.305-07:00",
        "name" : "Karl User the 609th",
        "username" : "producthunter605",
        "headline" : "Product Hunter",
        "twitter_username" : "hunter609",
        "website_url" : "http://awesome.io",
        "profile_url" : "http://www.producthunt.com/@producthunter605",
        "image_url" : {
          "30px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_normal.png",
          "32px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_normal.png",
          "40px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_normal.png",
          "44px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_normal.png",
          "48px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_normal.png",
          "50px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_bigger.png",
          "60px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_bigger.png",
          "64px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_bigger.png",
          "73px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_bigger.png",
          "80px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "88px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "96px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "100px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "110px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "120px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "132px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "146px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "160px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "176px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "220px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "264px" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "32px@2X" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4_bigger.png",
          "40px@2X" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "44px@2X" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "88px@2X" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "32px@3X" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "40px@3X" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "44px@3X" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "88px@3X" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png",
          "original" : "https://abs.twimg.com/sticky/default_profile_images/default_profile_4.png"
        }
      }
    }
  ]
}