Skip to main content
WORLD SUPPLYMARKETSVerify. Buy. Sell.
WSM PARTNER API · V1

Connect your app to World Supply Markets.

Bring public buyer requests and supplier offers into your company's tools. Applications such as AdsOnward can connect from their server using their own WSM API key.

YOUR CONNECTIONS

API keys

Loading your API connections…

GET CONNECTED

Start with one request

  1. Complete your WSM registration and sign in.
  2. Create an API key using your application or company name, for example AdsOnward.
  3. Save the key in your application's server settings and send it in the Authorization header.

Base URL: https://worldsupplymarkets.com/api/v1

curl "https://worldsupplymarkets.com/api/v1/inquiries?direction=sell" \
  -H "Authorization: Bearer YOUR_WSM_API_KEY"

Example for AdsOnward or another Node.js backend

Set WSM_API_KEY in that application's server environment. Keep the full key out of browser code, public repositories and page URLs.

const response = await fetch(
  "https://worldsupplymarkets.com/api/v1/inquiries?direction=sell",
  { headers: { Authorization: "Bearer " + process.env.WSM_API_KEY } }
);
if (!response.ok) throw new Error("WSM API request failed");
const { data, pagination } = await response.json();

Each listing includes its WSM page URL. Link back to that page for the full inquiry and the existing member contact flow.

AVAILABLE NOW

API endpoints

All four endpoints require Authorization: Bearer YOUR_WSM_API_KEY.

GET /api/v1

Check the connection and see its application name and limits.

GET /api/v1/inquiries

Read public marketplace summaries for buyer requests and supplier offers.

GET /api/v1/categories

Get product category IDs and names.

GET /api/v1/countries

Get country codes, names and filter values.

Inquiry fields

id, direction, category_id, category_name, country, title, quantity and url.

This is the public discovery feed of recent member posts and directory listings. Full inquiry text, product photos, contact details, private messages and payment records are outside this API.

FIND RELEVANT LISTINGS

Filters and pagination

direction
buy or sell; omit to include both.
category
A category ID from /api/v1/categories.
country
A country filter_value from /api/v1/countries.
q
Search text, up to 120 characters.
cursor
The next_cursor from the preceding response. Keep the same filters.

Responses include up to eight summaries in data. Continue using pagination.next_cursor until it is null. If a cursor becomes stale, restart without it.

CONTROL YOUR CONNECTIONS

Access and limits

The public:read scope is available after registration. No separate admin approval is required. Keys do not grant paid membership or access to private contacts, and this version supports GET requests only.

Allowances are shared by the keys belonging to one WSM account: 60 requests per minute and 5,000 per UTC day. Authorized requests count towards these limits, including requests with invalid filters. Read the rate-limit response headers and wait for Retry-After when a request returns 429.

400 Correct the filter or restart pagination.

401 Supply a valid, active API key.

403 The account is not eligible for API access.

405 Use GET; publishing through this API is unavailable.

429 Wait for the Retry-After interval.

503 The feed is temporarily unavailable; retry later.

Revoke a key from the API keys section to stop new requests using it. The full key cannot be recovered after you close its one-time display.

YOUR NEXT BUSINESS CONNECTION

What would you like to post?

I want to buyTell suppliers what you need.I want to sellShare your product and specifications.

Sign in to publish. Your email confirmation and membership determine access.

WORLD SUPPLY MARKETS

Marketplace assistance

AI assistant

Welcome to World Supply Markets. Ask me about joining, memberships, trade enquiries or preparing a buying requirement.