ShoveBid for #1

Shove developer resources

Machine-readable surfaces for Shove (shove.lol). This is not a partner platform. There is no OAuth, no API key, and no public write API beyond starting a checkout. Send Accept: text/markdown at the same URL as any public page to get this content as markdown.

Read the board

GET /api/board returns the live global board as JSON: listings with rank, bid, clicks, and cost per click, plus activity, stats, top bid, and crown price. Add ?category={slug} for one arena. Slugs: ai, devtools, seo, crypto, health, marketing, business, design, social, other.

Helpers the site uses

GET /api/meta?url= fetches Open Graph title, description, image, and favicon. Used by the bid form. GET /go/{id} increments public clicks and 302s to the listing URL. GET /og/{id} is the share card. GET /embed/{id} is an SVG badge that reads Shove #N · $X.

Payments

POST /api/checkout starts a Dodo Payments checkout. Body fields: input (URL or @handle), bid (whole US dollars), category, optional email, title, description, referrerId, and kind (NEW, TOPUP, or CROWN). It returns { url }. POST /api/webhook/dodo-payments is the Dodo webhook. Do not call it as a client. GET /api/demo-pay is local and demo only.

Agent files