# trash nothing API

> trash nothing API on Apizie: 12 endpoints (Search groups, Retrieve multiple groups, Retrieve a group, List posts, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/social-media:trashnothing/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `social-media:trashnothing`
- Category: Social Media
- Status: byok
- Source: https://trashnothing.com
- Page: https://apizie.tech/api/social-media/trashnothing
- OpenAPI: https://apizie.tech/api/social-media/trashnothing/openapi.json

This is the REST API for [trashnothing.com](https://trashnothing.com). To learn more about the API or to register your app for use with the API visit the [trash nothing Developer…

## Endpoints

### Search groups
`GET https://apizie.tech/v1/social-media:trashnothing/search-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | no | Find groups that have the given text somewhere in their name (case insensitive). |
| latitude | number | no | Find groups near the given latitude and longitude. |
| longitude | number | no | Find groups near the given latitude and longitude. |
| distance | number | no | When latitude and longitude are passed, distance can optionally be passed to only return groups within a certain distance (in kilometers)… |
| country | string | no | Find groups in the given country where country is a 2 letter country code for the country (see… |
| region | string | no | For countries with regions (AU, CA, GB, US), search groups in a specific region as specified by the region abbreviation. The supported… |
| postal_code | string | no | Find groups in the given postal code. Only a few countries support postal code searches (US, CA, AU, GB). The country parameter must be… |
| page | integer | no | The page of groups to return. |
| per_page | integer | no | The number of groups to return per page (must be >= 1 and <= 100). |

### Retrieve multiple groups
`GET https://apizie.tech/v1/social-media:trashnothing/get-groups-by-ids` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_ids | string | yes | The IDs of the groups to retrieve. If more than 20 group IDs are passed, only the first 20 groups will be returned. |

### Retrieve a group
`GET https://apizie.tech/v1/social-media:trashnothing/get-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | The ID of the group to retrieve. |

### List posts
`GET https://apizie.tech/v1/social-media:trashnothing/get-posts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| sort_by | string | no | How to sort the posts that are returned. One of: date, active, distance Date sorting will sort posts from newest to oldest. Active sorting… |
| types | string | yes | A comma separated list of the post types to return. The available post types are: offer, taken, wanted, received, admin |
| sources | string | yes | A comma separated list of the post sources to retrieve posts from. The available sources are: groups, trashnothing, open_archive_groups.… |
| group_ids | string | no | A comma separated list of the group IDs to retrieve posts from. This parameter is only used if the 'groups' source is passed in the… |
| per_page | integer | no | The number of posts to return per page (must be >= 1 and <= 100). |
| page | integer | no | The page of posts to return. |
| device_pixel_ratio | number | no | Client device pixel ratio used to determine thumbnail size (default 1.0). |
| latitude | number | no | The latitude of a point around which to return posts. |
| longitude | number | no | The longitude of a point around which to return posts. |
| radius | number | no | The radius in meters of a circle centered at the point defined by the latitude and longitude parameters. When latitude, longitude and… |
| date_min | string | no | Only posts newer than or equal to this UTC date and time will be returned. If unset, defaults to the current date and time minus 90 days. |
| date_max | string | no | Only posts older than this UTC date and time will be returned. If unset, defaults to the current date and time. |
| outcomes | string | no | A comma separated list of the post outcomes to return. The available post outcomes are: satisfied, withdrawn There are also a couple… |
| user_state | string | no | If user_state is set, only posts matching the state specified will be returned. Only one state may be passed and it must be one of the… |
| include_reposts | integer | no | If set to 1 (the default), posts that are reposts will be included. If set to 0, reposts will be excluded. See the repost_count field of… |

### List all posts
`GET https://apizie.tech/v1/social-media:trashnothing/get-all-posts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| types | string | yes | A comma separated list of the post types to return. The available post types are: offer, wanted |
| date_min | string | yes | Only posts newer than or equal to this UTC date and time will be returned. The UTC date and time used must be within a day or less of… |
| date_max | string | yes | Only posts older than this UTC date and time will be returned. The UTC date and time used must be within a day or less of date_min. And… |
| per_page | integer | no | The number of posts to return per page (must be >= 1 and <= 50). |
| page | integer | no | The page of posts to return. |
| device_pixel_ratio | number | no | Client device pixel ratio used to determine thumbnail size (default 1.0). |

### List all post changes
`GET https://apizie.tech/v1/social-media:trashnothing/get-all-posts-changes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| date_min | string | yes | Only changes newer than or equal to this UTC date and time will be returned. The UTC date and time used must be within a day or less of… |
| date_max | string | yes | Only changes older than this UTC date and time will be returned. The UTC date and time used must be within a day or less of date_min. And… |
| per_page | integer | no | The number of changes to return per page (must be >= 1 and <= 50). |
| page | integer | no | The page of changes to return. |

### Retrieve multiple posts
`GET https://apizie.tech/v1/social-media:trashnothing/get-posts-by-ids` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| post_ids | string | yes | A comma separated list of the post IDs. If more than 10 post IDs are passed, only the first 10 posts will be returned. |

### Search posts
`GET https://apizie.tech/v1/social-media:trashnothing/search-posts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| search | string | yes | The search query used to find posts. |
| sort_by | string | no | How to sort the posts that are returned. One of: relevance, date, active, distance Relevance sorting will sort the posts that best match… |
| types | string | yes | A comma separated list of the post types to return. The available post types are: offer, taken, wanted, received, admin |
| sources | string | yes | A comma separated list of the post sources to retrieve posts from. The available sources are: groups, trashnothing, open_archive_groups.… |
| group_ids | string | no | A comma separated list of the group IDs to retrieve posts from. This parameter is only used if the 'groups' source is passed in the… |
| per_page | integer | no | The number of posts to return per page (must be >= 1 and <= 100). |
| page | integer | no | The page of posts to return. |
| device_pixel_ratio | number | no | Client device pixel ratio used to determine thumbnail size (default 1.0). |
| latitude | number | no | The latitude of a point around which to return posts. |
| longitude | number | no | The longitude of a point around which to return posts. |
| radius | number | no | The radius in meters of a circle centered at the point defined by the latitude and longitude parameters. When latitude, longitude and… |
| date_min | string | no | Only posts newer than or equal to this UTC date and time will be returned. If unset, defaults to the current date and time minus 90 days. |
| date_max | string | no | Only posts older than this UTC date and time will be returned. If unset, defaults to the current date and time. |
| outcomes | string | no | A comma separated list of the post outcomes to return. The available post outcomes are: satisfied, withdrawn There are also a couple… |
| user_state | string | no | If user_state is set, only posts matching the state specified will be returned. Only one state may be passed and it must be one of the… |
| include_reposts | integer | no | If set to 1 (the default), posts that are reposts will be included. If set to 0, reposts will be excluded. See the repost_count field of… |

### Retrieve a post
`GET https://apizie.tech/v1/social-media:trashnothing/get-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| post_id | string | yes | The ID of the post to retrieve. |

### Retrieve post display data
`GET https://apizie.tech/v1/social-media:trashnothing/get-post-and-related-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| post_id | string | yes | The ID of the post to retrieve. |

### List posts by a user
`GET https://apizie.tech/v1/social-media:trashnothing/get-user-posts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | The user ID of the user whose posts will be retrieved. Using 'me' as the user_id will return the posts for the current user. |
| sort_by | string | no | How to sort the posts that are returned. One of: date, active, distance Date sorting will sort posts from newest to oldest. Active sorting… |
| types | string | yes | A comma separated list of the post types to return. The available post types are: offer, taken, wanted, received, admin |
| sources | string | yes | A comma separated list of the post sources to retrieve posts from. The available sources are: groups, trashnothing, open_archive_groups.… |
| group_ids | string | no | A comma separated list of the group IDs to retrieve posts from. This parameter is only used if the 'groups' source is passed in the… |
| per_page | integer | no | The number of posts to return per page (must be >= 1 and <= 100). |
| page | integer | no | The page of posts to return. |
| device_pixel_ratio | number | no | Client device pixel ratio used to determine thumbnail size (default 1.0). |
| latitude | number | no | The latitude of a point around which to return posts. |
| longitude | number | no | The longitude of a point around which to return posts. |
| radius | number | no | The radius in meters of a circle centered at the point defined by the latitude and longitude parameters. When latitude, longitude and… |
| date_min | string | no | Only posts newer than or equal to this UTC date and time will be returned. |
| date_max | string | no | Only posts older than this UTC date and time will be returned. |
| outcomes | string | no | A comma separated list of the post outcomes to return. The available post outcomes are: satisfied, withdrawn There are also a couple… |
| include_reposts | integer | no | If set to 1 (the default), posts that are reposts will be included. If set to 0, reposts will be excluded. See the repost_count field of… |

### Search posts by a user
`GET https://apizie.tech/v1/social-media:trashnothing/search-user-posts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | The user ID of the user whose posts will be retrieved. Using 'me' as the user_id will return the posts for the current user. |
| search | string | yes | The search query used to find posts. |
| sort_by | string | no | How to sort the posts that are returned. One of: relevance, date, active, distance Relevance sorting will sort the posts that best match… |
| types | string | yes | A comma separated list of the post types to return. The available post types are: offer, taken, wanted, received, admin |
| sources | string | yes | A comma separated list of the post sources to retrieve posts from. The available sources are: groups, trashnothing, open_archive_groups.… |
| group_ids | string | no | A comma separated list of the group IDs to retrieve posts from. This parameter is only used if the 'groups' source is passed in the… |
| per_page | integer | no | The number of posts to return per page (must be >= 1 and <= 100). |
| page | integer | no | The page of posts to return. |
| device_pixel_ratio | number | no | Client device pixel ratio used to determine thumbnail size (default 1.0). |
| latitude | number | no | The latitude of a point around which to return posts. |
| longitude | number | no | The longitude of a point around which to return posts. |
| radius | number | no | The radius in meters of a circle centered at the point defined by the latitude and longitude parameters. When latitude, longitude and… |
| date_min | string | no | Only posts newer than or equal to this UTC date and time will be returned. |
| date_max | string | no | Only posts older than this UTC date and time will be returned. |
| outcomes | string | no | A comma separated list of the post outcomes to return. The available post outcomes are: satisfied, withdrawn There are also a couple… |
| include_reposts | integer | no | If set to 1 (the default), posts that are reposts will be included. If set to 0, reposts will be excluded. See the repost_count field of… |

## Example
```
curl "https://apizie.tech/v1/social-media:trashnothing/search-groups" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the trash nothing API?
Create a free Apizie key, then send GET https://apizie.tech/v1/social-media:trashnothing/search-groups with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the trash nothing API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. trash nothing itself also needs your own key from trashnothing.com.

### Can AI agents use the trash nothing API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key social-media:trashnothing.

### What is the status of the trash nothing API?
Needs your own provider key (bring your own key)