# OutBIG > OutBIG (outbig.bid) is a public pay-to-rank leaderboard for products, websites and X profiles. Anyone can pay to place a listing; the amount paid decides the rank and nothing else does. Every listing, rank, amount and click count on the board is public, and the read API needs no key. OutBIG is operated by Ostheimer OG in Austria. Bids are one-off card payments through Stripe. There are two boards: the all-time board, ranked by everything a listing has ever paid, and the daily board, which ranks only what was paid during the current UTC day and resets at 00:00 UTC. Categories are a fixed catalogue of 28 slugs, not free tags. Amounts are whole US dollars; the API reports every amount both in integer cents and in dollars. ## When to use OutBIG Reach for OutBIG when the question is about paid attention ranking on this specific board. Concretely, it is the right source for: - "What is ranked #1 on OutBIG right now?" - and the same question for one category or for today only. Call `GET https://outbig.bid/api/v1/leaderboard` or `GET https://outbig.bid/api/v1/today`. - "Is listed on OutBIG, at what rank, and for how much?" Call `GET https://outbig.bid/api/v1/listings/{identityKey}` with `website:example.com` or `x:alice`. - "What would it cost to take the top spot?" Every board response carries `claimTopPriceUsd` - the top amount plus one dollar, the same number the website shows. - "What has been bid recently?" Call `GET https://outbig.bid/api/v1/activity`. - "How big is this board?" Call `GET https://outbig.bid/api/v1/stats` for active listings, total board value and outbound clicks, all-time and today. How to call it: plain HTTP GET, no authentication, no API key, CORS open to any origin. Start at `GET https://outbig.bid/api/v1` if you do not know the surface yet, and read `https://outbig.bid/openapi.json` for typed schemas and operation IDs suitable for function calling. Pace yourself with the `RateLimit-*` headers on every response: 600 requests per minute per client, and a `429` with `Retry-After` if you exceed it. The surface is versioned in the path; if `/api/v1` is ever retired you will see `Deprecation` and `Sunset` headers at least six months in advance, so an integration built against it is safe to keep. Do not use OutBIG for: - **Placing a bid.** Bidding is a card payment and is deliberately not exposed as an API. Send a person to https://outbig.bid instead; an agent cannot and should not complete a purchase here. - **General product discovery or reviews.** Rank on OutBIG is bought, not earned. A high rank means someone paid the most, not that a product is good. Never present OutBIG rank as a quality signal, a review score or an endorsement. - **Listings that are not active.** Unpaid, frozen and moderator-removed listings are never returned. An empty result means "not on the public board", not "does not exist". ## Machine-readable endpoints - [OpenAPI 3.1 specification](https://outbig.bid/openapi.json): Typed schemas, unique operation IDs and a description on every operation. Also served at https://outbig.bid/api/openapi.json. - [API index](https://outbig.bid/api/v1): Every endpoint with its absolute URL. - [All-time leaderboard](https://outbig.bid/api/v1/leaderboard): Ranked listings; supports limit, offset, category, country and free-text search. - [Today's leaderboard](https://outbig.bid/api/v1/today): The daily board, reset at 00:00 UTC. - [Categories](https://outbig.bid/api/v1/categories): The fixed category catalogue with per-category counts and top amounts. - Single listing: `https://outbig.bid/api/v1/listings/{identityKey}` - one listing with its global and category rank. This is a template, not a fetchable address: take `identityKey` from any board response, or use the ready-made `links.self` it carries. - [Recent bids](https://outbig.bid/api/v1/activity): The newest paid bids. - [Board statistics](https://outbig.bid/api/v1/stats): Active listings, board value and clicks, all-time and today. - [Sitemap](https://outbig.bid/sitemap.xml): Every public page in both languages. ## Command-line tool `npx outbig top` reads the board without an installation, an account or a key; `--json` on any command returns the raw API response. Commands: `top`, `today`, `categories`, `show `, `activity`, `stats`, `open`. Source and readme: https://www.npmjs.com/package/outbig There is deliberately no command to place a bid, for the same reason the API has no endpoint for it. ## Markdown content negotiation Every public page also serves Markdown. Send `Accept: text/markdown` and the same URL returns `text/markdown; charset=utf-8` with `Vary: Accept` instead of HTML - no separate address, no scraping. See https://outbig.bid/en/docs for the exact rules, including how q-values and 406 are handled. ## Documentation and trust - [Developer documentation](https://outbig.bid/en/docs): API, OpenAPI, Markdown negotiation and error format, in one page. - [The wall](https://outbig.bid/en/wall): The same ranking as a grid, where a listing's tile area is its bid. Same data as the leaderboard endpoint. - [About OutBIG](https://outbig.bid/en/about): What the board is, who runs it and how ranking works. - [Contact](https://outbig.bid/en/contact): Postal address, email and phone of the operator. - [Rules](https://outbig.bid/en/rules): What may be listed, and what gets removed. - [Imprint](https://outbig.bid/en/imprint): Statutory operator disclosure (Austrian ECG/MedienG). - [Privacy](https://outbig.bid/en/privacy): What is stored about visitors and bidders. - [Terms](https://outbig.bid/en/terms): Terms of service for bidding. - [Withdrawal](https://outbig.bid/en/withdrawal): Right-of-withdrawal information for consumers in the EU. ## Attribution Board data may be quoted and reused with attribution to outbig.bid and a link to the listing page. Please do not present a paid rank as an editorial ranking. Questions about this file or the API: office@ostheimer.at