Put the whole media library inside your own system
One REST API over 40,000+ Chinese self-media and media outlets, plus the global creator database. Agencies, SaaS products and MCNs integrate directly instead of trading spreadsheets.
The API is part of the VIP plan. Create an account and talk to us to switch it on.
curl https://kol.ltd/api/ext/self-media?category=cn_wemedia \
-H "Authorization: Bearer kol_live_xxxxxxxxxxxx"
{
"data": [
{
"id": "mbx_10241",
"account_name": "科技每日推送",
"platform": "微信公众号",
"category": "cn_wemedia",
"price": "480.00",
"currency": "CNY",
"delivery_days": 1
}
],
"total": 43105
}Who it is for
Wire the catalogue, its pricing and order status into the systems you already run.
Agencies and PR firms
Sync current inventory and pricing straight into your own rate card instead of asking us for a spreadsheet every week.
Platforms and SaaS
Show the catalogue inside your own product, take the order, and hand the published link back to your customer.
Pricing and research
Pull quotes in bulk by platform, industry and region for cost analysis and competitive work.
Automation
Hook publishing into your content calendar or ticketing system so status changes land there by themselves.
What is available today
These are live right now and answer to any valid key.
| GET | /api/ext/self-media | Search the publishing catalogue by platform, industry, keyword and page |
| GET | /api/ext/self-media/facets | List the categories, platforms and industries you can filter by |
| GET | /api/ext/self-media/{id} | One outlet, with its price and lead time |
| POST | /api/ext/orders | Place a publishing order, charged to the account wallet |
| GET | /api/ext/orders | List this account's publishing orders |
| GET | /api/ext/orders/{id} | One order in full, with each item's status and published link |
| POST | /api/ext/orders/{id}/pay | Pay a pending order after topping up |
| POST | /api/ext/orders/{id}/items/{itemId}/request-refund | Open a refund request against one item |
| GET | /api/ext/wallet | Read the account's wallet balance |
| GET | /api/ext/wallet/ledger | Read the wallet ledger: top-ups, spending and refunds |
| GET | /api/ext/creators | Search global creators by platform, follower tier and keyword |
| GET | /api/ext/creators/{id} | One creator profile with its audience data |
| GET | /api/ext/campaigns | List campaigns |
| GET | /api/ext/analytics | Account-level performance summary |
| GET | /api/ext/me | Check that a key is valid |
Full field reference and examples: openapi.json
Three steps to integrate
Create an account
Sign up, switch on VIP, and the key generator appears in your settings.
Generate a key
A key is shown in full exactly once. Store it the way you store a password.
Start calling
Send the Authorization header to /api/ext and read plain JSON back.
The fine print
🔐 Keys are tied to an account
Every key belongs to whoever created it. Call /me to confirm which account you are acting as: the order and wallet endpoints only ever see that account's data, and orders only ever spend its balance.
🧯 You decide how much it can spend
Every key carries its own per-order and daily cap, and ordering can be switched off entirely. Over the per-order cap returns 403, over the daily cap returns 429, and the wallet is not touched either way. Call /me to see how much of today's allowance is left.
A key belongs to the account that created it, and orders spend that account's wallet. Store it the way you store a password.
Need a higher rate limit or a dedicated endpoint?
VIP accounts can ask for a dedicated quota, IP allow-listing and custom fields.