Developers

Build on ThreadzSocial

Read marketplace data over a stable REST API. Public GETs work without a key; protected routes use Bearer API keys you create and revoke in your account.

Production base URL

Use this host for live integrations. Full docs cover paths, auth, and sandbox rules.

https://www.threadzsocial.com/api/v1

Sandbox Hub

See every listing you pushed with a sandbox key — stats, status filters, and a photo grid. Never on Discover.

/developers/sandbox · sign-in required

Path to production

  1. Create an account and complete your profile.
  2. Accept the API Terms and register a developer app (Apps).
  3. Create a sandbox key, call /me, push listings, then open Sandbox Hub to see them (not on Discover).
  4. Complete go-live milestones, then request production access (Go live).
  5. After staff approval, create live keys.

API health

Public readiness signal — no key required. Use before wiring integrations or debugging outages.

GET https://www.threadzsocial.com/api/v1/health · data.ok is true when the service is healthy; data.db is ok, error, or skipped. HTTP 503 means the database is configured but unreachable. This is not a full public status page — only the API process + optional DB ping.

curl
curl -sS https://www.threadzsocial.com/api/v1/health

Quick test

After creating a sandbox key on your app dashboard:

curl
curl -sS https://www.threadzsocial.com/api/v1/health
curl -sS -H "Authorization: Bearer YOUR_KEY" \
  https://www.threadzsocial.com/api/v1/me

Full reference: API docs. Rate limits and acceptable use: API Terms. Platform Terms and Privacy still apply. Operators: repo Docs/DEVELOPER_API.md.