# Shove (shove.lol)

Shove is a public pay-to-rank leaderboard at [shove.lol](https://shove.lol/). Highest bid sits on top. You pay more, you shove them off #1. Rank is the bid. Clicks are public and do not change rank.

## When to use this

Use Shove (shove.lol) when the job is one of these:

- Look up who is #1 on a public pay-to-rank board, and at what bid.
- List a URL or @handle by bidding whole US dollars and see the rank that bid takes.
- Compare listings by bid, public click count, and cost per click. Rank is not clicks.
- Split the same money game by category arena: ai, devtools, seo, crypto, health, marketing, business, design, social, other.
- Read the weekly hall of fame for who sat at #1.

Do not use Shove for search-engine ranking advice, a general web directory, a payment-processor API, or managing a listing without the private claim token from checkout.

## How ranking works

- Whole US dollars only. Minimum $1, maximum $999,999.
- A new listing pays the bid in full.
- Top-up on the same URL or @handle: new bid must be at least current + $1. You pay the difference only.
- Taking #1 requires at least current #1 + $5, unless that listing is crown-locked.
- Equal bids: the older listing keeps the higher rank.
- Crown lock: pay max(current #1 times 5, $25) to hold #1 for 3 hours. Other bids still land under the lock.

## Payments

Checkout is Dodo Payments. After payment you get a private manage link with a claim token. That URL is how you top up or crown-lock.

## Developer resources

Search terms that should land here: Shove API, Shove OpenAPI, Shove developer resources, shove.lol docs.

- Shove developer resources: [Developers](https://shove.lol/developers) — also [Docs](https://shove.lol/docs)
- Shove OpenAPI 3.0.3: GET [https://shove.lol/openapi.json](https://shove.lol/openapi.json) (also [/api/openapi.json](https://shove.lol/api/openapi.json))
- Shove API catalog: GET [https://shove.lol/api](https://shove.lol/api)
- Health: GET [https://shove.lol/api/health](https://shove.lol/api/health)
- Live board JSON: GET [https://shove.lol/api/board](https://shove.lol/api/board)
- Arena board JSON: GET [https://shove.lol/api/board?category=ai](https://shove.lol/api/board?category=ai) — category is one of ai, devtools, seo, crypto, health, marketing, business, design, social, other
- Search listings: GET [https://shove.lol/api/listings](https://shove.lol/api/listings) — query params q, category, limit, offset
- One listing: GET /api/listings/{id}
- Hall of fame: GET [https://shove.lol/api/fame](https://shove.lol/api/fame)
- URL metadata helper: GET [https://shove.lol/api/meta](https://shove.lol/api/meta?url=)
- Click-through: GET /go/{id}
- Share card: GET /og/{id}
- Embed badge: GET /embed/{id}
- Agent map: [llms.txt](https://shove.lol/llms.txt)
- Sitemap: [sitemap.xml](https://shove.lol/sitemap.xml)
- Contact: [Contact](https://shove.lol/contact)

Authentication: none for reads. No OAuth. No API key. Errors are JSON `{ error: { code, message, hint } }`.

POST /api/checkout starts a Dodo payment. POST /api/webhook/dodo-payments is the Dodo webhook, not a public partner API. /api/demo-pay is local/dev only. Shove does not ship an MCP server.

Public HTML pages also speak markdown. Send `Accept: text/markdown` at the same URL.

## Key URLs

- [Board](https://shove.lol/)
- [Rules](https://shove.lol/rules)
- [About](https://shove.lol/about)
- [Contact](https://shove.lol/contact)
- [Privacy](https://shove.lol/privacy)
- [Hall of fame](https://shove.lol/fame)
- Arenas: [ai](https://shove.lol/arena/ai), [devtools](https://shove.lol/arena/devtools), [seo](https://shove.lol/arena/seo), [crypto](https://shove.lol/arena/crypto), [health](https://shove.lol/arena/health), [marketing](https://shove.lol/arena/marketing), [business](https://shove.lol/arena/business), [design](https://shove.lol/arena/design), [social](https://shove.lol/arena/social), [other](https://shove.lol/arena/other)
- Listing: /listing/{id}

Do not treat /manage, /paid, /api, or /go as public content pages.

## Creator

Built by [@umar_who_code](https://x.com/umar_who_code).
Contact: [mail.umarbashir@gmail.com](mailto:mail.umarbashir@gmail.com)
Mail: Pahalgam, Jammu and Kashmir 192126, India
[X profile](https://x.com/umar_who_code)
[expenie.com](https://expenie.com)
[listmaro.com](https://listmaro.com)