ozbargain.com.au APIozbargain.com.au ↗
Access current OzBargain deals by category or fetch top upvoted bargains site-wide. Returns price, store, votes, expiry, and more via two endpoints.
curl -X GET 'https://api.parse.bot/scraper/9da4a0cf-f11f-47a5-b74d-5fedcff931d1/get_computer_deals?limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch current deals from a specified category on OzBargain. Returns deals with title, price, store, votes, and other metadata. Paginates automatically to fill the requested limit.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of deals to return. |
{
"type": "object",
"fields": {
"count": "integer total number of deals returned",
"deals": "array of deal objects with title, url, price, description, store, upvotes, downvotes, expiry, and category"
},
"sample": {
"data": {
"count": 1,
"deals": [
{
"url": "https://www.ozbargain.com.au/node/959247",
"price": "$139, $229, $0",
"store": "umart.com.au",
"title": "Logitech MX Keys S Wireless Keyboard $139 (RRP $229) + Delivery ($0 C&C) @ Umart",
"expiry": "14 May Today",
"upvotes": 36,
"category": "Computing",
"downvotes": 0,
"description": "Thought I'd post this as I saw the Amazon deal posted earlier..."
}
]
},
"status": "success"
}
}About the ozbargain.com.au API
The OzBargain API exposes two endpoints that return structured deal data from OzBargain.com.au, covering up to 8 fields per deal including title, price, store, upvotes, downvotes, expiry, and category. The get_computer_deals endpoint retrieves deals from a specific category with optional pagination via the limit parameter, while get_top_deals surfaces the most upvoted active deals across the entire site sorted by community votes descending.
What the API Returns
Both endpoints return a count integer and a deals array. Each deal object includes title, url, price, description, store, upvotes, downvotes, expiry, and category. The upvotes and downvotes fields reflect live community voting, giving a real-time signal of deal quality as judged by the OzBargain community.
Endpoints and Parameters
get_computer_deals accepts an optional limit integer and paginates automatically to fulfill it — useful when you need a fixed-size batch of deals from a single category. get_top_deals also accepts a limit parameter and returns deals ranked by upvotes descending, pulling from across all categories on the OzBargain front page. Neither endpoint requires authentication.
Data Shape and Freshness
The expiry field indicates when a deal closes, which lets you filter out stale listings on the client side. The store field names the retailer, enabling per-retailer aggregation. The price field is a string as posted by the deal submitter, so it may include qualifiers like "free" or percentage discounts rather than always being a numeric value. Both endpoints reflect current live data from OzBargain.
- Build a deal alert system that monitors upvote counts and notifies users when a deal surpasses a threshold
- Aggregate deals by store using the
storefield to compare which retailers post the most active bargains - Filter deals by
expiryto display only deals still active in a browser extension or app - Display a live trending-deals widget sorted by
upvotesusing theget_top_dealsendpoint - Track price patterns across categories by logging the
priceandcategoryfields over time - Build a comparison tool that shows
upvotesvsdownvotesratios to surface genuinely popular deals
| 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 OzBargain have an official developer API?+
What does `get_top_deals` return and how is it sorted?+
get_top_deals returns deals from across all OzBargain categories, sorted by upvotes in descending order. Each result includes upvotes, downvotes, title, price, store, expiry, url, and category. You can control how many results come back using the optional limit parameter.Can I retrieve deals from a specific category other than the default?+
get_computer_deals endpoint is scoped to a single category. If you need deals from a different category — such as groceries, travel, or gaming — you can fork this API on Parse and revise the endpoint to target the category of your choice.Does the API include deal comments, vote history, or user profile data?+
How fresh is the deal data returned by the API?+
expiry field on each deal indicates when the deal is set to close, but deals marked as expired may still appear if they haven't been removed from the source listings. Checking expiry client-side is the reliable way to filter stale results.