Developer API
Build with GEG.
Access our entire catalogue, search, orders and cart from your own application. Get an API key in minutes — start integrating today.
Fast & cacheable
ETag + Cache-Control headers. JSON responses designed for high-throughput.
Scoped keys
Each integration only gets the permissions it needs. Revoke instantly.
Self-documenting
Hit GET /api/v1 to discover every endpoint, scope and example.
Endpoints
All requests must be authenticated with Authorization: Bearer gep_live_…
| Method | Path | Scope | Description |
|---|---|---|---|
| GET | /api/v1 | — | Returns API metadata and the endpoint catalogue. |
| GET | /api/v1/products | products.read | List products. Query params: q, category, sort, page, limit. |
| GET | /api/v1/products/{id} | products.read | Retrieve a single product by id or slug. |
| GET | /api/v1/categories | categories.read | List all categories with product counts. |
| GET | /api/v1/search?q=… | search.read | Full-text search across the catalogue. |
Examples
List products
bashcurl https://geteverygoods.com/api/v1/products \
-H "Authorization: Bearer gep_live_…"Search the catalogue
bashcurl "https://geteverygoods.com/api/v1/search?q=phone" \
-H "Authorization: Bearer gep_live_…"JavaScript / fetch
jsconst res = await fetch("https://geteverygoods.com/api/v1/products?limit=12", {
headers: { Authorization: "Bearer " + API_KEY },
});
const { data, pagination } = await res.json();Python
pythonimport requests
r = requests.get(
"https://geteverygoods.com/api/v1/products",
headers={"Authorization": f"Bearer {API_KEY}"},
params={"page": 1, "limit": 20},
)
products = r.json()["data"]Rate limits & errors
Every API key gets a configurable per-minute and per-day budget. Default is 60 / min and 10,000 / day.
| Status | Meaning |
|---|---|
| 401 | Unauthorized — invalid, missing or revoked key |
| 403 | Forbidden — required scope is not granted |
| 404 | Not found — resource does not exist |
| 429 | Too many requests — respect the Retry-After header |
| 500 | Internal server error — please retry |