Find an API

Search public APIs with auth details & Postman guides

← All APIs

trash nothing

trashnothing · Social

Social No Auth Free & Open social

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 page](https://trashnothing.com/developer). NOTE: All date-time values are [UTC](https://en.wikipedia.org/wiki/Coordinated_Universal_Time) and are in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) (eg. 2019-02-03T01:23:53).

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET List conversations

List conversations

https://api.apis.guru/v2/specs/trashnothing.com/1.3/conversations?page=1&category=inbox&per_page=10&num_messages=10&device_pixel_ratio=1&include_num_unread=0

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/trashnothing.com/1.3/conversations?page=1&category=inbox&per_page=10&num_messages=10&device_pixel_ratio=1&include_num_unread=0"
import requests
params = {
    "page": "1",
    "category": "inbox",
    "per_page": "10",
    "num_messages": "10",
    "device_pixel_ratio": "1",
    "include_num_unread": "0"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/trashnothing.com/1.3/conversations",
    params=params,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/trashnothing.com/1.3/conversations');
url.searchParams.set('page', '1');
url.searchParams.set('category', 'inbox');
url.searchParams.set('per_page', '10');
url.searchParams.set('num_messages', '10');
url.searchParams.set('device_pixel_ratio', '1');
url.searchParams.set('include_num_unread', '0');

const response = await fetch(url); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/trashnothing.com/1.3/conversations")
	q := baseURL.Query()
	q.Set("page", "1")
	q.Set("category", "inbox")
	q.Set("per_page", "10")
	q.Set("num_messages", "10")
	q.Set("device_pixel_ratio", "1")
	q.Set("include_num_unread", "0")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/trashnothing.com/1.3/conversations")
uri.query = URI.encode_www_form({
  "page" => "1",
  "category" => "inbox",
  "per_page" => "10",
  "num_messages" => "10",
  "device_pixel_ratio" => "1",
  "include_num_unread" => "0"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/trashnothing.com/1.3/conversations?" . http_build_query([
    "page" => "1",
    "category" => "inbox",
    "per_page" => "10",
    "num_messages" => "10",
    "device_pixel_ratio" => "1",
    "include_num_unread" => "0"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET Search groups

Search groups

https://api.apis.guru/v2/specs/trashnothing.com/1.3/groups?name=test&page=1&region=us-east-1&country=US&distance=100&latitude=51.5074&per_page=20&longitude=-0.1278&postal_code=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/trashnothing.com/1.3/groups?name=test&page=1&region=us-east-1&country=US&distance=100&latitude=51.5074&per_page=20&longitude=-0.1278&postal_code=example"
import requests
params = {
    "name": "test",
    "page": "1",
    "region": "us-east-1",
    "country": "US",
    "distance": "100",
    "latitude": "51.5074",
    "per_page": "20",
    "longitude": "-0.1278",
    "postal_code": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/trashnothing.com/1.3/groups",
    params=params,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/trashnothing.com/1.3/groups');
url.searchParams.set('name', 'test');
url.searchParams.set('page', '1');
url.searchParams.set('region', 'us-east-1');
url.searchParams.set('country', 'US');
url.searchParams.set('distance', '100');
url.searchParams.set('latitude', '51.5074');
url.searchParams.set('per_page', '20');
url.searchParams.set('longitude', '-0.1278');
url.searchParams.set('postal_code', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/trashnothing.com/1.3/groups")
	q := baseURL.Query()
	q.Set("name", "test")
	q.Set("page", "1")
	q.Set("region", "us-east-1")
	q.Set("country", "US")
	q.Set("distance", "100")
	q.Set("latitude", "51.5074")
	q.Set("per_page", "20")
	q.Set("longitude", "-0.1278")
	q.Set("postal_code", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/trashnothing.com/1.3/groups")
uri.query = URI.encode_www_form({
  "name" => "test",
  "page" => "1",
  "region" => "us-east-1",
  "country" => "US",
  "distance" => "100",
  "latitude" => "51.5074",
  "per_page" => "20",
  "longitude" => "-0.1278",
  "postal_code" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/trashnothing.com/1.3/groups?" . http_build_query([
    "name" => "test",
    "page" => "1",
    "region" => "us-east-1",
    "country" => "US",
    "distance" => "100",
    "latitude" => "51.5074",
    "per_page" => "20",
    "longitude" => "-0.1278",
    "postal_code" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET List posts

NOTE: When paging through the posts returned by this endpoint, there will be at most 1,000 posts that can be returned (eg. 50 pages worth of posts with the default per_page value of 20). In areas where there are more than 1,000 posts, clients can use more specific query parameters to adjust which p

https://api.apis.guru/v2/specs/trashnothing.com/1.3/posts?page=1&types=example&radius=1&sort_by=date&sources=example&date_max=example&date_min=example&latitude=51.5074&outcomes=&per_page=20&group_ids=The group IDs of every group the current user is a member of.&longitude=-0.1278&user_state=&include_reposts=1&device_pixel_ratio=1

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/trashnothing.com/1.3/posts?page=1&types=example&radius=1&sort_by=date&sources=example&date_max=example&date_min=example&latitude=51.5074&outcomes=&per_page=20&group_ids=The%20group%20IDs%20of%20every%20group%20the%20current%20user%20is%20a%20member%20of.&longitude=-0.1278&user_state=&include_reposts=1&device_pixel_ratio=1"
import requests
params = {
    "page": "1",
    "types": "example",
    "radius": "1",
    "sort_by": "date",
    "sources": "example",
    "date_max": "example",
    "date_min": "example",
    "latitude": "51.5074",
    "outcomes": "",
    "per_page": "20",
    "group_ids": "The group IDs of every group the current user is a member of.",
    "longitude": "-0.1278",
    "user_state": "",
    "include_reposts": "1",
    "device_pixel_ratio": "1"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/trashnothing.com/1.3/posts",
    params=params,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/trashnothing.com/1.3/posts');
url.searchParams.set('page', '1');
url.searchParams.set('types', 'example');
url.searchParams.set('radius', '1');
url.searchParams.set('sort_by', 'date');
url.searchParams.set('sources', 'example');
url.searchParams.set('date_max', 'example');
url.searchParams.set('date_min', 'example');
url.searchParams.set('latitude', '51.5074');
url.searchParams.set('outcomes', '');
url.searchParams.set('per_page', '20');
url.searchParams.set('group_ids', 'The group IDs of every group the current user is a member of.');
url.searchParams.set('longitude', '-0.1278');
url.searchParams.set('user_state', '');
url.searchParams.set('include_reposts', '1');
url.searchParams.set('device_pixel_ratio', '1');

const response = await fetch(url); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/trashnothing.com/1.3/posts")
	q := baseURL.Query()
	q.Set("page", "1")
	q.Set("types", "example")
	q.Set("radius", "1")
	q.Set("sort_by", "date")
	q.Set("sources", "example")
	q.Set("date_max", "example")
	q.Set("date_min", "example")
	q.Set("latitude", "51.5074")
	q.Set("outcomes", "")
	q.Set("per_page", "20")
	q.Set("group_ids", "The group IDs of every group the current user is a member of.")
	q.Set("longitude", "-0.1278")
	q.Set("user_state", "")
	q.Set("include_reposts", "1")
	q.Set("device_pixel_ratio", "1")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/trashnothing.com/1.3/posts")
uri.query = URI.encode_www_form({
  "page" => "1",
  "types" => "example",
  "radius" => "1",
  "sort_by" => "date",
  "sources" => "example",
  "date_max" => "example",
  "date_min" => "example",
  "latitude" => "51.5074",
  "outcomes" => "",
  "per_page" => "20",
  "group_ids" => "The group IDs of every group the current user is a member of.",
  "longitude" => "-0.1278",
  "user_state" => "",
  "include_reposts" => "1",
  "device_pixel_ratio" => "1"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/trashnothing.com/1.3/posts?" . http_build_query([
    "page" => "1",
    "types" => "example",
    "radius" => "1",
    "sort_by" => "date",
    "sources" => "example",
    "date_max" => "example",
    "date_min" => "example",
    "latitude" => "51.5074",
    "outcomes" => "",
    "per_page" => "20",
    "group_ids" => "The group IDs of every group the current user is a member of.",
    "longitude" => "-0.1278",
    "user_state" => "",
    "include_reposts" => "1",
    "device_pixel_ratio" => "1"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗
  1. See official documentation for authentication and setup.

What can you build with trash nothing?

trash nothing is a Social API. Developers commonly use social APIs for:

  • adding social login (Sign in with Google/Twitter)
  • fetching user-generated content for analysis
  • scheduling and publishing social posts
  • tracking mentions and engagement metrics
  • building community dashboards

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. trash nothing is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗