| 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: W/"d6ce379eb739518157ccbf5101c379a8"
Last-Modified: Wed, 05 May 2021 11:39:06 GMT
Content-Type: application/json; charset=utf-8
Cache-Control: max-age=0, private, must-revalidate
Content-Length: 3793
Body
{
"posts": [
{
"comments_count": 0,
"id": 1432,
"name": "Awesome Idea #23",
"product_state": "default",
"tagline": "Great new search engine",
"slug": "awesome-idea-23",
"votes_count": 0,
"day": "2021-05-05",
"category_id": null,
"created_at": "2021-05-05T04:39:06.831-07:00",
"current_user": {},
"discussion_url": "http://www.producthunt.com/posts/awesome-idea-23?utm_campaign=producthunt-api\u0026utm_medium=api\u0026utm_source=Application%3A+Awesome+Oauth+App+%2318+%28ID%3A+1208%29",
"exclusive": null,
"featured": true,
"ios_featured_at": false,
"maker_inside": false,
"makers": [],
"platforms": [],
"redirect_url": "http://www.producthunt.com/r/9df32f26f6f42b/1432?app_id=1208",
"screenshot_url": {
"300px": "http://placehold.it/850x850.png",
"850px": "http://placehold.it/850x850.png"
},
"thumbnail": {
"id": 1481,
"media_type": "image",
"image_url": "https://ph-files.imgix.net/334c5b6b-ef2b-401f-bd9e-905546d57867?auto=format\u0026fit=crop\u0026h=570\u0026w=430",
"metadata": {}
},
"topics": [],
"user": {
"id": 9570,
"created_at": "2021-05-05T04:39:06.809-07:00",
"name": "Karl User the 94th",
"username": "producthunter94",
"headline": "Product Hunter",
"twitter_username": "hunter94",
"website_url": "http://awesome.io",
"profile_url": "http://www.producthunt.com/@producthunter94",
"image_url": {
"30px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"32px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"40px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"44px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"48px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"50px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"60px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"64px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"73px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"80px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"88px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"96px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"100px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"110px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"120px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"132px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"146px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"160px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"176px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"220px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"264px": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"32px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"40px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"44px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"88px@2X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"32px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"40px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"44px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"88px@3X": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress",
"original": "https://ph-static.imgix.net/guest-user-avatar.png?auto=format\u0026auto=compress"
}
}
}
]
}