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

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

Request
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.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

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

Related Tags

Similar APIs

View All →