| 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?search[url]=http%3A%2F%2Fwww.example.com
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: "437059f3998211048024929b21fe0863"
Content-Type: application/json; charset=utf-8
Cache-Control: max-age=0, private, must-revalidate
Content-Length: 4174
Body
{
"posts" : [
{
"category_id" : 1,
"comments_count" : 0,
"day" : "2017-07-13",
"id" : 1,
"name" : "Awesome Idea #23",
"product_state" : "default",
"tagline" : "Great new search engine",
"ios_featured_at" : null,
"created_at" : "2017-07-13T13:31:20.132-07:00",
"current_user" : {},
"discussion_url" : "http://www.producthunt.com/posts/awesome-idea-23?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2319+%28ID%3A+1%29",
"exclusive" : null,
"featured" : true,
"maker_inside" : false,
"makers" : [],
"platforms" : [],
"topics" : [],
"redirect_url" : "http://www.producthunt.com/r/39b9bfa28ed139/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/0bf33da8-a37d-427e-aeaa-08aa2d98336f?auto=format&fit=crop&h=570&w=430",
"metadata" : {}
},
"user" : {
"id" : 2,
"created_at" : "2017-07-13T13:31:20.127-07:00",
"name" : "Karl User the 96th",
"username" : "producthunter96",
"headline" : "Product Hunter",
"twitter_username" : "hunter96",
"website_url" : "http://awesome.io",
"profile_url" : "http://www.producthunt.com/@producthunter96",
"image_url" : {
"30px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=30&h=30",
"32px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=32&h=32",
"40px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=40&h=40",
"44px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=44&h=44",
"48px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=48&h=48",
"50px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=50&h=50",
"60px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=60&h=60",
"64px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=64&h=64",
"73px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=73&h=73",
"80px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=80&h=80",
"88px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=88&h=88",
"96px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=96&h=96",
"100px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=100&h=100",
"110px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=110&h=110",
"120px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=120&h=120",
"132px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=132&h=132",
"146px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=146&h=146",
"160px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=160&h=160",
"176px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=176&h=176",
"220px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=220&h=220",
"264px" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=264&h=264",
"32px@2X" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=64&h=64",
"40px@2X" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=80&h=80",
"44px@2X" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=88&h=88",
"88px@2X" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=176&h=176",
"32px@3X" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=96&h=96",
"40px@3X" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=120&h=120",
"44px@3X" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=132&h=132",
"88px@3X" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=264&h=264",
"original" : "https://avatars-cdn.producthunt.com/2/original?auto=format&fit=crop&crop=faces&w=original&h=original"
}
},
"votes_count" : 0
}
]
}