Trash Nothing API

Social / OAuth Advanced HTTPS CORS
Varies by plan (check documentation)

Overview

Trash Nothing is the API for a popular freecycling platform where community members post free items they no longer need. With it you can browse listings, search for items, and post offers programmatically in your local area. It is a good project for developers interested in sustainability apps or local-community features.

💡

Beginner Tip

Register your app at trashnothing.com/developer to receive OAuth credentials, then use the /api/v1/items endpoint to start browsing available free items in any location.

Available Data

Trash Nothing data via REST API
JSON-formatted response data
Requires OAuth authentication

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Trash Nothing",
    "description": "A freecycling community with thousands of free items posted every day",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

items List of freecycle item objects matching the search criteria.
items[].id Unique identifier for the item listing.
items[].title Short title describing the free item being offered.
items[].type Listing type: "offer" for items available, "wanted" for items someone is looking for.
items[].location Geographic location object with lat/lng coordinates of the listing.

Implementation Example

const url = "https://trashnothing.com/developer";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Missing or expired OAuth access token in the Authorization header.
Refresh your OAuth token using the refresh_token grant before retrying the request.
403 Forbidden Your app does not have permission to perform the requested action.
Check the permission scopes granted during OAuth authorization and request additional scopes if needed.
400 Bad Request: missing required parameter A required query parameter such as lat or lng was omitted.
Always include both lat and lng when searching for location-based items.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 2/20
🔒 Security 15/15
🛠 Developer XP 8/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS YES
Category Social
Difficulty Advanced
Verified: 2026-04-04

Similar APIs

View All →