The Pillar API
Find the ad windows, city billboards and casino game sponsorships for lease on The Pillar and what each costs. JSON, no key, no login. Built for AI agents and the people who build them.
Markdown copy: /developers.md. OpenAPI: /openapi.json.
Basics
Base URL: https://thepillar.io/api/v1. Every response is JSON. No key or login is needed.
A window is a licensed ad pane on the tower, not property: a brand's logo and link on the glass, billed monthly through Stripe, cancel any month. Tower windows cost $9 to $392.85 a month by floor and position (corner panes cost 35% more); city billboards cost $4 to $7; a casino game sponsorship (kind=casino, ids like C-slots: your name, logo and link on one game in the play-chips casino) costs $19.
Prices are monthly, in US cents (priceCents) and as text (price). They are exactly what Stripe charges.
Errors look like {"error":{"code":"bad_request","message":"floor must be from 1 to 80"}}. Each IP address can make 120 requests a minute; past that you get a 429 with a Retry-After header.
MCP server
https://thepillar.io/mcp is an MCP server (Streamable HTTP, no key or login) with the same steps as tools: find_windows, get_window, get_prices, start_lease and check_lease. Add it to Claude or ChatGPT as a custom connector, or to any MCP client, then ask it to put a brand on The Pillar.
start_lease returns checkoutUrl just like the API: the person pays on Stripe, then the agent follows the lease with check_lease until it's live. The same limits apply: 120 requests a minute and 10 lease starts an hour per IP address.
Let your agent pay (sign in once)
https://thepillar.io/mcp/account is the same MCP server for an agent signed in to a person's Pillar account. Add it to Claude, ChatGPT or Claude Code: the app opens a Pillar page where the person enters their email (a 6-digit code), saves a card on Stripe's page and picks a monthly limit. Under the hood that's OAuth 2.1 with PKCE; the app registers itself (dynamic registration or a client ID metadata document).
There, start_lease charges the saved card and starts the monthly renewal, within the limit (the monthly total of the windows the account's agents keep running). The window lights at once, or after a person's review for some kinds of ads. The person gets a receipt by email with a 24-hour undo. Two more tools: my_leases, and cancel_lease (within 24 hours it undoes with a full refund; later it ends the lease with no refund for the current month).
To try it with real money: the cheapest city billboard is $4 a month, and a signed-in agent's purchase can be undone within 24 hours for a full refund (cancel_lease, or the undo link in the receipt).
The REST API takes a token too: POST /api/v1/leases with Authorization: Bearer <token> (a token for the resource https://thepillar.io/api/v1) pays the same way. Discovery: https://thepillar.io/.well-known/oauth-protected-resource/mcp/account and https://thepillar.io/.well-known/oauth-authorization-server.
If the bank wants the person to confirm a payment, or the card is declined, you get checkoutUrl instead: give it to them. Limits: 5 agent purchases an hour per account.
Pay with x402 (no account)
An agent with a USDC wallet on Base can lease a slot by itself, with no account, card or checkout page: POST https://thepillar.io/api/v1/leases/x402 with the same JSON as POST /api/v1/leases. It follows x402 version 2 (scheme exact, network eip155:8453, USDC).
Without a payment, the answer is 402 with a PAYMENT-REQUIRED header: the slot's monthly price in USDC (6 decimals, so $4 is 4000000), the address to pay and a 120-second limit. Nothing is stored and the ad isn't checked yet. Sign those terms with an x402 client and send the same request again with the PAYMENT-SIGNATURE header.
Then the ad is checked, the slot is held, the payment settles and the window lights. The answer is 201 with a PAYMENT-RESPONSE header and leaseId, endsAt, payer and transaction. Follow it at /api/v1/leases/{leaseId} like any lease.
One payment buys one month (30 days). Nothing renews by itself: paying again for the same window and website, from the same owner, adds 30 days after the current end. Otherwise the window frees itself within a day after endsAt.
With email, the window belongs to that email: it gets the emails and can end the lease early at /desk (no refund). Without it, the paying wallet owns the window and nothing is emailed; only that wallet can renew it.
Payments with x402 are final: there's no 24-hour undo. Ads that need a person's review (the held kinds in the rules below) can't be paid this way: they get 409 needs_review with nothing charged; use POST /api/v1/leases for those. If a payment goes through but the ad can't be placed, a person sends the USDC back to the paying wallet.
Errors: 402 again when the payment is missing, doesn't match the current price, or is turned down (the reason is in error.code); 409 taken, needs_review or payment_used; 422 content_refused; 503 x402_off or facilitator_unavailable. Nothing is charged in any of these. A paid request counts toward the 10 lease starts an hour per IP address; a request without a payment counts as a read.
The official x402 client (@x402/core 2.x) refuses any payment over $1 unless you raise maxAmountPerPayment in its spendControls, and every slot here costs $4 or more.
List free windows and billboards
GET /api/v1/windows returns the free slots, cheapest floors first (by floor, then south, east, north, west, then column), then the billboards.
Filters: kind (window or billboard), floor, floorMin, floorMax (1 to 80), face (south, east, north, west), spot (corner or middle), maxPrice (US dollars). Any floor, face or spot filter returns tower windows only.
Pages: limit (1 to 100, default 50). When next isn't null, pass it as cursor for the next page.
Example: curl "https://thepillar.io/api/v1/windows?floor=47&spot=corner&limit=2"
{
"items": [
{
"id": "F47-S1",
"kind": "window",
"floor": 47,
"face": "south",
"column": 1,
"spot": "corner",
"priceCents": 9180,
"price": "$91.80",
"currency": "USD",
"billing": "monthly",
"pageUrl": "https://thepillar.io/w/F47-S1",
"leaseUrl": "https://thepillar.io/w/F47-S1/lease",
"image": "https://thepillar.io/w/F47-S1/opengraph-image"
},
{
"id": "F47-E1",
"kind": "window",
"floor": 47,
"face": "east",
"column": 1,
"spot": "corner",
"priceCents": 9180,
"price": "$91.80",
"currency": "USD",
"billing": "monthly",
"pageUrl": "https://thepillar.io/w/F47-E1",
"leaseUrl": "https://thepillar.io/w/F47-E1/lease",
"image": "https://thepillar.io/w/F47-E1/opengraph-image"
}
],
"next": "4711"
}One window or billboard
GET /api/v1/windows/{id} returns { item, available, reason }. Window ids look like F47-S1 (floor 47, south face, column 1); billboard ids like B-1234.
When available is false, reason says why: taken (lit by a brand), reserved (paid, in review), paused, prize (a game prize, only its winner can lease it) or crown (the King of the Tower window, never sold).
Prices
GET /api/v1/prices returns every floor's monthly price for a middle and a corner pane, and the billboard range.
Start a lease
POST /api/v1/leases with JSON: windowId and brandUrl (required), and optionally brandName (40), pitch (140), pricingText (80), logoUrl, banner (billboards: { "fit": "cover" } fills the board), and email (prefills Stripe).
The ad is checked before anything is charged. The answer is 201 with leaseId, checkoutUrl, expiresAt (60 minutes), priceCents, review and message. Give checkoutUrl to the person: they pay the monthly price on Stripe. Nobody needs an account; the window belongs to the email they pay with.
When review is true, a person approves the ad after payment (usually within a day) and it stays dark until then; if it isn't approved, the payment is refunded in full.
Errors: 409 when the slot isn't free (taken, reserved, paused, prize, crown), 422 content_refused with a category and the reason (nothing is charged), 400 for bad input, 429 after 10 lease starts an hour from one IP.
Example: curl -X POST https://thepillar.io/api/v1/leases -H "Content-Type: application/json" -d '{"windowId":"F47-S3","brandUrl":"https://example.com"}'
{
"leaseId": "lc_3f9c2a7b1e5d4c8a9b0e1f2a",
"checkoutUrl": "https://checkout.stripe.com/c/pay/cs_live_...",
"expiresAt": "2026-10-08T18:00:00.000Z",
"priceCents": 6800,
"status": "awaiting_payment",
"review": false,
"message": "Open checkoutUrl to pay $68 a month on Stripe. The window lights up as soon as the payment goes through."
}Check a lease
GET /api/v1/leases/{leaseId} returns status: awaiting_payment, in_review (paid, a person checks it first), live, refused (nothing charged), rejected_refunded, refunded (the slot was taken while paying), expired (the link ran out unpaid), ended, renewed (a payment that added a month to an x402 lease) or refund_due (an x402 payment went through but the window couldn't be placed; a person sends the USDC back), with a plain message.
With a token from the account that owns the lease (the same kind of token as for POST /api/v1/leases), a live lease also has stats: the window's views (times someone opened its panel in the 3D tower) and clicks on the brand's link, for the last 7 days, the last 30 days and since it went live. my_leases on /mcp/account shows the same. Only the owner sees these numbers.
What can go on The Pillar
Never allowed (refused before payment): illegal drugs; weapons, ammunition and explosives; fake or stolen goods; scams, phishing and malware; sexual content; hate and violent extremism; anything sexual involving minors; pretending to be a brand or person you're not. Allowed only after a person reviews it (paid, then held until approved): gambling; crypto and investment offers; cannabis and CBD; alcohol; tobacco and vapes; medicines and health claims; dating; political ads. Casino game sponsorships also refuse gambling. Everything else (ordinary companies, products, apps, shops, creators and causes) is allowed.
Live windows are re-checked every day, and anyone can report one from its page.
Without code
Each item's leaseUrl is a plain lease form (/w/{id}/lease) that works without JavaScript, so a browser agent or a person can fill it in and go straight to Stripe.
Machine-readable files
OpenAPI 3.1: https://thepillar.io/openapi.json. API catalog (RFC 9727): https://thepillar.io/.well-known/api-catalog.
MCP server: https://thepillar.io/mcp, and signed in to an account: https://thepillar.io/mcp/account. Sign-in metadata: https://thepillar.io/.well-known/oauth-authorization-server.
The catalog as a page: https://thepillar.io/lease, and as markdown: https://thepillar.io/lease.md. Both take the same filters as the API.
Shopping feeds: https://thepillar.io/feeds/google.xml (Google Merchant Center) and https://thepillar.io/feeds/openai.jsonl (OpenAI product feed).
Site guides for AI: https://thepillar.io/llms.txt and https://thepillar.io/llms-full.txt.
Contact
Questions or a bug: contact@extensionsmarket.com.