API Documentation

Import Gateway REST API v1 — access supplier and product data programmatically

Authentication

All API requests require an API key via the Authorization header:

curl -H "Authorization: Bearer ig_live_your_key_here" \
https://clearance.market/api/v1/suppliers

Rate Limits

Free

100 req/day

Pro

1,000 req/day

Endpoints

GET/api/v1/suppliers

List suppliers with pagination and filters

?page=1&limit=20&country=CN&category=steel&verification=verified

GET/api/v1/suppliers/:slug

Get supplier detail with materials and products

GET/api/v1/products

List products with search and filters

?page=1&limit=20&search=steel&supplier=slug&category=slug

GET/api/v1/categories

List all categories with supplier counts

POST/api/v1/quotes

Submit a quote request

Example: Create Quote

curl -X POST https://clearance.market/api/v1/quotes \
  -H "Authorization: Bearer ig_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"buyer_name":"John","buyer_email":"john@co.com","material_description":"Steel coils","quantity":"10 tons"}'

Response Format

All list endpoints return paginated responses:

{
"data": [...],
"meta": { "page": 1, "limit": 20, "total": 150, "pages": 8 }
}

Loading…