Charity API
ebay · Commerce
The Charity API allows third-party developers to search for and access details on supported charitable organizations.
Authentication
No authentication requiredFree to use with no key needed.
Sample Requests
GET
getCharityOrgs
This call is used to search for supported charitable organizations. It allows users to search for a specific charitable organization, or for multiple charitable organizations, from a particular charitable domain and/or geographical region, or by using search criteria. The call returns pag
https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org?q=test&limit=10&offset=0®istration_ids=example
Hover any highlighted part to learn what it does
Headers — extra info sent with the request
| X-EBAY-C-MARKETPLACE-ID | example |
curl -X GET "https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org?q=test&limit=10&offset=0®istration_ids=example" \ -H "X-EBAY-C-MARKETPLACE-ID: example"
import requests
params = {
"q": "test",
"limit": "10",
"offset": "0",
"registration_ids": "example"
}
headers = {
"X-EBAY-C-MARKETPLACE-ID": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org');
url.searchParams.set('q', 'test');
url.searchParams.set('limit', '10');
url.searchParams.set('offset', '0');
url.searchParams.set('registration_ids', 'example');
const response = await fetch(url, {
headers: {
'X-EBAY-C-MARKETPLACE-ID': 'example'
},
});
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/ebay.com/commerce-charity/v1.2.1/charity_org")
q := baseURL.Query()
q.Set("q", "test")
q.Set("limit", "10")
q.Set("offset", "0")
q.Set("registration_ids", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
req.Header.Set("X-EBAY-C-MARKETPLACE-ID", "example")
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/ebay.com/commerce-charity/v1.2.1/charity_org")
uri.query = URI.encode_www_form({
"q" => "test",
"limit" => "10",
"offset" => "0",
"registration_ids" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
req["X-EBAY-C-MARKETPLACE-ID"] = "example"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org?" . http_build_query([
"q" => "test",
"limit" => "10",
"offset" => "0",
"registration_ids" => "example"
]);
$opts = ["http" => [
"method" => "GET",
"header" => implode("\r\n", [
"X-EBAY-C-MARKETPLACE-ID: example"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET
getCharityOrg
This call is used to retrieve detailed information about supported charitable organizations. It allows users to retrieve the details for a specific charitable organization using its charity organization ID.
https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org/{charity_org_id}
Hover any highlighted part to learn what it does
Headers — extra info sent with the request
| X-EBAY-C-MARKETPLACE-ID | example |
curl -X GET "https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org/{charity_org_id}" \
-H "X-EBAY-C-MARKETPLACE-ID: example"import requests
headers = {
"X-EBAY-C-MARKETPLACE-ID": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org/{charity_org_id}",
headers=headers,
)
print(response.json())const url = 'https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org/{charity_org_id}';
const response = await fetch(url, {
headers: {
'X-EBAY-C-MARKETPLACE-ID': 'example'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
targetURL := "https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org/{charity_org_id}"
req, _ := http.NewRequest("GET", targetURL, nil)
req.Header.Set("X-EBAY-C-MARKETPLACE-ID", "example")
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/ebay.com/commerce-charity/v1.2.1/charity_org/{charity_org_id}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
req["X-EBAY-C-MARKETPLACE-ID"] = "example"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/commerce-charity/v1.2.1/charity_org/{charity_org_id}";
$opts = ["http" => [
"method" => "GET",
"header" => implode("\r\n", [
"X-EBAY-C-MARKETPLACE-ID: example"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Charity API?
Charity API is a Commerce API. Developers commonly use commerce APIs for:
- syncing product catalogues and inventory levels
- building price comparison and deal-finder tools
- processing orders and tracking shipments
- managing customer wishlists and reviews
- automating abandoned-cart and promotional emails
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Charity API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide