Trash Nothing API

Social / OAuth Advanced HTTPS CORS

65 C

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

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

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

Trash Nothing data via REST API

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "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

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://trashnothing.com/api/v1/items?lat=37.77&lng=-122.41&radius=10";
// 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

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

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

How is this scored? →