bidorbuy.co.za APIbidorbuy.co.za ↗
Access Bob Shop product listings, seller profiles, ratings, category browsing, and search suggestions via 8 structured API endpoints covering the South African marketplace.
curl -X GET 'https://api.parse.bot/scraper/ae1b3d88-7bf8-4e47-9cd4-98b9e9a398ce/search_products?query=phone' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Bob Shop with keywords and optional filters. Returns paginated results with full product card data including pricing, seller info, images, and category details.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination. |
| sort | string | Sort order. Accepted values: DEFAULT, PRICE_ASC, PRICE_DESC, NEWEST, HOT_SELLING. |
| queryrequired | string | Search keywords. |
| condition | string | Item condition filter. Accepted values: NEW, SECONDHAND, REFURBISHED. |
| max_price | string | Maximum price filter. |
| min_price | string | Minimum price filter. |
| sale_type | string | Listing type filter. Accepted values: BUY_NOW, AUCTION. |
| category_id | string | Category ID to filter by. Use -1 for all categories. |
{
"type": "object",
"fields": {
"trade": "array of product objects with title, amount, url, images, seller, condition, category info",
"pageNumber": "integer, current page number",
"totalPages": "integer, total number of pages available",
"resultsPerPage": "integer, number of results on current page"
},
"sample": {
"data": {
"trade": [
{
"url": "https://www.bobshop.co.za/hp-laptop-14-df0xxx-4gb-ram-500gb-hdd-windows-10/p/680011855",
"type": "FIXED_PRICE",
"title": "HP Laptop 14-df0xxx 4GB RAM 500GB HDD Windows 10",
"amount": 4800,
"images": [
{
"image": "https://img.bobshop.co.za/...",
"thumbnail": "https://img.bobshop.co.za/..."
}
],
"seller": {
"userId": 5630844,
"verified": false,
"userAlias": "AyaFan1170"
},
"tradeId": 680011855,
"condition": "SECOND_HAND"
}
],
"pageNumber": 1,
"totalPages": 4500,
"resultsPerPage": 36
},
"status": "success"
}
}About the bidorbuy.co.za API
The Bob Shop API exposes 8 endpoints covering product search, detailed listings, seller profiles, buyer ratings, category navigation, and homepage promotions from South Africa's bidorbuy.co.za marketplace. The search_products endpoint accepts keyword queries with filters for condition, price range, sale type, and category, returning paginated product cards with pricing in ZAR, seller names, images, and full category paths.
Product Search and Listings
The search_products endpoint accepts a required query string plus optional filters: condition (NEW, SECONDHAND, REFURBISHED), sale_type (BUY_NOW or AUCTION), min_price/max_price bounds, and a category_id. Results include a trade array of product objects with title, amount, URL, images, seller identity, and category details, alongside pageNumber, totalPages, and resultsPerPage fields for cursor-free pagination. Sort order is configurable via DEFAULT, PRICE_ASC, PRICE_DESC, NEWEST, or HOT_SELLING.
Product Details and Category Browsing
get_product_details accepts a numeric product_id and returns a richer data shape: full attributes as key-value pairs, a complete category path string, an array of images, and the price in ZAR. get_category_listings lets you browse a category by its numeric ID — use get_category_tree first to retrieve the flat list of top-level category IDs and names available on the site. Both endpoints return the same paginated trade array structure as search results.
Seller Data and Ratings
get_seller_profile returns all active listings for a seller identified by seller_id, with an optional seller_name slug for URL construction. get_seller_ratings returns an array of review objects — each with productName, type (positive, neutral, or negative), and comment — plus a summary object keyed by time period (Past month, Past 3 months, Total till date) with counts for positive, neutral, negative, and dispute classifications.
Search Suggestions and Promotions
search_suggestions takes a partial query string and returns suggestion objects with suggestionText, type (WithCategory or TextOnly), and optional categoryName, categoryId, and tradeCount fields — useful for autocomplete features. get_homepage_promotions requires no inputs and returns the current Weekend Specials product array with the same trade structure as other listing endpoints.
- Build a price comparison tool for South African buyers by querying
search_productswithmin_price/max_pricefilters and sorting by PRICE_ASC. - Monitor seller reputation over time by polling
get_seller_ratingsand tracking the summary counts across Past month, Past 3 months, and Total till date. - Populate an autocomplete search bar using
search_suggestionsto returnsuggestionTextwith associatedcategoryNameandtradeCount. - Aggregate category-level inventory by iterating
get_category_listingsacross all IDs returned byget_category_tree. - Track weekend promotional pricing by periodically calling
get_homepage_promotionsand storing the returnedtradearray. - Build a seller comparison dashboard by pulling active listings via
get_seller_profileand cross-referencing ratings fromget_seller_ratings. - Extract detailed product attributes for structured data pipelines using the
attributesobject returned byget_product_details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Bob Shop (bidorbuy.co.za) have an official developer API?+
What does `get_seller_ratings` return beyond a star score?+
get_seller_ratings returns individual review objects — each including the productName the review relates to, a type (positive, neutral, or negative), and the reviewer's comment. It also returns a summary object broken down by three time windows (Past month, Past 3 months, Total till date), each containing counts for positive, neutral, negative, and dispute entries. There is no single aggregate score field in the response.Can I filter search results to auctions only?+
sale_type=AUCTION to search_products. The accepted values for that parameter are BUY_NOW and AUCTION. You can combine this filter with condition, min_price, max_price, and category_id in the same request.Does the API cover completed or historical sales data?+
search_products, get_category_listings, and get_seller_profile, plus current promotions via get_homepage_promotions. Historical or completed transaction data is not exposed. You can fork this API on Parse and revise it to add an endpoint targeting completed listings if that data is available on the site.Does pagination use cursors or page numbers?+
search_products, get_category_listings, get_seller_profile) accept an optional page string parameter and return pageNumber and totalPages integers in the response. There is no cursor or offset-based pagination. get_seller_ratings and get_homepage_promotions do not paginate — they return results in a single response.