trash nothing

List stories

GET

/stories

stories

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://trashnothing.com/api/v1.2/stories'

Response Example

200 - Example 1

{
    "stories": [
        {
            "content": "People helping people - it doesn't get better than this!",
            "date": "2020-04-25T10:26:32",
            "like_count": 3,
            "photos": [
                {
                    "images": [
                        {
                            "height": 120,
                            "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.90x120.jpg",
                            "width": 90
                        },
                        {
                            "height": 240,
                            "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.180x240.jpg",
                            "width": 180
                        },
                        {
                            "height": 360,
                            "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.270x360.jpg",
                            "width": 270
                        },
                        {
                            "height": 500,
                            "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.375x500.jpg",
                            "width": 375
                        }
                    ],
                    "photo_id": "695624-768616",
                    "thumbnail": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.90x120.jpg",
                    "url": "https://trashnothing.com/img/2018-02-05/cfsbfm-39051735845_379baab73f.375x500.jpg"
                }
            ],
            "share_url": "https://trashnothing.com/story/7584",
            "story_id": 7584,
            "title": "Sharing is caring",
            "user": {
                "about_me": "Just an old fisherman looking to reuse more.",
                "country": "GB",
                "firstname": null,
                "lastname": null,
                "member_since": "2017-01-27T06:35:55",
                "profile_image": "https://lh3.googleusercontent.com/-1qVLzuOCyYg/AAAAAAAAAAI/AAAAAAAAAAA/0aGNzRAO61c/s64-c/100783935580725962164.jpg",
                "user_id": 2946512,
                "username": "fred gibson"
            }
        }
    ]
}

Request

Query Params

page

integer

optional

The page of stories to return.

per_page

integer

optional

The number of stories to return per page (must be >= 1 and <= 50).

sort_by

string

optional

How to sort the stories that are returned. One of: date, distance, likes, views

Setting sort_by to date will sort posts from newest to oldest. Setting sort_by to distance will sort posts from nearest to farthest. Setting sort_by to likes will sort posts with the most likes first. Setting sort_by to views will show the posts with the most views first.

latitude

number

optional

Find groups near the given latitude and longitude.

longitude

number

optional

Find groups near the given latitude and longitude.

device_pixel_ratio

number

optional

Client device pixel ratio used to determine thumbnail size (default 1.0).

Responses

🟢200The stories and paging data.

application/json

Body

stories

array[object (Story) {9}]

optional

content

string

optional

date

string <date-time>

optional

The UTC date and time when the post was published.

like_count

integer

optional

The number of people who have liked this story.

photos

array[object (Photo) {5}]

optional

Details about the photos associated with this story (may be null if there are no photos).

share_url

string

optional

A URL that can be used to share the story (may be null if the story is not public).

story_id

string

optional

title

string

optional

user

object (User)

optional

Example:

{"about_me":"Just an old fisherman looking to reuse more.","country":"GB","feedback":{"percent_positive":87.5,"restriction":"no-recent-messages","score":7},"firstname":null,"lastname":null,"member_since":"2017-01-27T06:35:55","profile_image":"https://lh3.googleusercontent.com/-1qVLzuOCyYg/AAAAAAAAAAI/AAAAAAAAAAA/0aGNzRAO61c/s64-c/100783935580725962164.jpg","reply_time":4850,"user_id":2946512,"username":"fred gibson"}

user_liked

boolean

optional

Whether or not the current user has liked this story or not.

🟠400Missing or invalid parameters.

Modified at 2022-09-11 18:59:48

Withdraw a post

Submit a story