outbid APIoutbid.lol ↗
Retrieve ranked product listings, bid amounts, click counts, and category data from outbid.lol via two structured endpoints.
What is the outbid API?
The outbid.lol API provides access to a bid-driven product leaderboard through 2 endpoints, returning 10 fields per product including bid amounts, click counts, and rank positions. Use get_leaderboard to pull up to 50 ranked products per page filtered by category, or get_product_info to fetch a single product's full profile including its overall rank, category rank, and external URL.
curl -X GET 'https://api.parse.bot/scraper/dabe5afc-fca1-419a-9874-12ff186a9daa/get_product_info?product_slug=see.io' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace outbid-lol-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: outbid.lol SDK — browse the leaderboard and drill into a product."""
from parse_apis.outbid_lol_api import OutbidLol, InputNotFound
client = OutbidLol()
# List top products on the overall leaderboard (capped to 5 items).
for product_summary in client.product_summaries.list(limit=5):
print(product_summary.name, f"${product_summary.amount_spent}", product_summary.clicks, "clicks")
# Drill down: take the first product and fetch its full detail page.
top = client.product_summaries.list(limit=1).first()
if top is not None:
detail = top.details()
print(f"#{detail.overall_rank} overall, #{detail.category_rank} in {detail.category}")
print(detail.title, detail.product_url)
# Browse available categories.
for cat in client.categories.list(limit=5):
print(cat.name, f"top bid: ${cat.top_bid}")
# Filter leaderboard by a category discovered above.
if top is not None:
for item in client.product_summaries.list(category=detail.category_slug, limit=3):
print(item.name, f"${item.amount_spent}")
# Handle a missing product gracefully.
try:
missing = client.product_summaries.list(limit=1).first()
if missing is not None:
missing.details()
except InputNotFound:
print("Product not found on the board")
print("exercised: product_summaries.list / details / categories.list / InputNotFound")
Retrieve detailed information about a specific product listed on outbid.lol, including its description, category, bid amount, click count, ranking positions, and external URL. Returns one product's full profile page data.
| Param | Type | Description |
|---|---|---|
| product_slugrequired | string | The product's URL slug on outbid.lol, typically the domain name (e.g. 'see.io', 'tutti.so', 'joni.ai'). Obtainable from the get_leaderboard endpoint's slug field. |
{
"type": "object",
"fields": {
"slug": "string — the product's identifier/slug",
"title": "string — full product title as displayed on the detail page",
"clicks": "integer — total click count the listing has received",
"category": "string — the marketplace category the product is listed in",
"posted_at": "string — ISO 8601 datetime when the listing was created",
"description": "string — product description explaining what it does",
"product_url": "string — external URL to the product's website",
"amount_spent": "integer — total amount in USD bid/spent on the leaderboard",
"overall_rank": "integer — rank position on the overall leaderboard",
"category_rank": "integer — rank position within its category",
"category_slug": "string — URL slug of the category",
"total_on_board": "integer — total products listed on the entire board",
"total_in_category": "integer — total number of products in the same category"
},
"sample": {
"data": {
"slug": "see.io",
"title": "see.io · see your idea live",
"clicks": 35811,
"category": "AI Agents & Infrastructure",
"posted_at": "2026-08-24T08:48:56.493Z",
"description": "Just describe your idea. AI turns it into a fully built, live website in minutes. Get your own domain whenever you want one. No coding required.",
"product_url": "https://see.io/?utm_source=outbid",
"amount_spent": 17000,
"overall_rank": 1,
"category_rank": 1,
"category_slug": "ai-agents-infrastructure",
"total_on_board": 1859,
"total_in_category": 89
},
"status": "success"
}
}About the outbid API
Leaderboard Data
The get_leaderboard endpoint returns an array of products ranked by bid spend on outbid.lol. Each entry includes slug, name, description, category, amount_spent, clicks, domain, and posted_at. The endpoint also returns a categories array listing every available marketplace category with its name, slug, and current top_bid, making it straightforward to discover which categories are active and competitive. Up to 50 products are returned per page. Omit the category parameter to retrieve the overall leaderboard, or pass a category slug such as 'ai-agents-infrastructure' or 'developer-tools' to filter results to a specific vertical.
Product Detail Data
The get_product_info endpoint accepts a product_slug — typically the product's domain (e.g. 'tutti.so', 'joni.ai') — and returns the full listing profile. Response fields include title, description, product_url, amount_spent, clicks, category, posted_at, overall_rank, and category_rank. The dual rank fields let you compare a product's standing across the full leaderboard against its position within a narrower category.
Coverage and Scope
Both endpoints reflect the public outbid.lol marketplace, where products bid for visible rank positions. The amount_spent field is denominated in USD and represents cumulative bid spend, not a per-period budget. The clicks field tracks total click-throughs the listing has received since creation. The posted_at field is an ISO 8601 datetime indicating when the listing was first created.
The outbid API is a managed, monitored endpoint for outbid.lol — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when outbid.lol changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official outbid.lol API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track how a product's
overall_rankandcategory_rankchange over time as competitors increase theiramount_spent - Build a competitive analysis tool showing which products dominate a given category by
top_bidandclicks - Monitor newly posted listings using
posted_attimestamps fromget_leaderboardto surface recent entrants - Identify high-traffic listings by sorting on
clicksfrom leaderboard results - Aggregate category-level bid data using the
categoriesarray returned byget_leaderboard - Look up a specific competitor's
product_url,description, andamount_spentviaget_product_infousing their domain slug
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does outbid.lol have an official developer API?+
What does the `get_leaderboard` endpoint return for categories?+
products array, the endpoint returns a categories array. Each element includes the category's name, slug, and top_bid — the highest single bid amount currently in that category. This is returned on every leaderboard call regardless of whether a category filter is applied.Does the API support pagination beyond 50 products?+
get_leaderboard endpoint returns up to 50 products per call. There is no built-in pagination parameter exposed in the current API. You can fork this API on Parse and revise it to add an offset or page parameter to retrieve deeper leaderboard results.Does the API expose historical bid or rank data over time?+
amount_spent, overall_rank, and category_rank as they appear on the leaderboard now. Historical snapshots or time-series rank tracking are not included. You can fork this API on Parse and revise it to add a history endpoint if outbid.lol exposes that data.How is `overall_rank` different from `category_rank` in `get_product_info`?+
overall_rank is the product's position across every listing on the outbid.lol leaderboard regardless of category. category_rank is its position only among other products in the same category. A product can rank highly in a niche category while sitting much lower on the global leaderboard.