Developers
Read the public catalogue of OBI Winga sellers through the OBI Business API, or build on the seller workspace API.
OBI Business API (public marketplace)
https://api.obibusiness.com/api/v1OBI Winga API (seller workspace)
https://winga-api.obibusiness.com/api/v1Public marketplace
No sign-in needed. Answers are JSON.
| GET | /marketplace/products?country=TZ&q=&category= | Public products of active sellers in a country. |
| GET | /marketplace/products/{id} | One product with its options. |
| GET | /shops/{slug} | A seller's page and public products. |
| GET | /categories?service=brokers | Main categories shared by all sellers. |
| GET | /countries | Countries, currencies and seller counts. |
Seller workspace
Needs a signed-in OBI account with a role in the business.
| GET | /me/businesses | Businesses of the signed-in person. |
| GET | /businesses/{id}/products | All products of the business. |
| POST | /businesses/{id}/products | Add a product (main category, sub category, price, visibility). |
| GET | /businesses/{id}/orders | Orders with status and payments. |
| POST | /businesses/{id}/orders/{order}/payments | Record a payment on an order. |
| GET | /main-categories | Main categories for the product form. |
Example
curl "https://api.obibusiness.com/api/v1/marketplace/products?country=TZ&category=fashion"Sign-in and keys
- Public marketplace calls need no key.
- Workspace calls use the OBI sign-in (the obi_sso cookie set when you sign in on any obibusiness.com site). Send the header X-OBI-Request: 1 with every change.
- Systems that connect to OBI Business server to server get their own system key from OBI. Ask Support 24/7 to connect a system.