# sponsor.ink

> Guest post marketplace with escrow. Buy sponsored placements on named publisher sites via REST API.

## Documentation
- Human-readable API docs: https://sponsor.ink/api-docs
- OpenAPI 3.1 spec: https://sponsor.ink/openapi.json
- MCP server: https://sponsor.ink/mcp
- Smithery MCP listing: https://smithery.ai/servers/lan-media/sponsor-ink
- Postman REST collection: https://documenter.getpostman.com/view/57843870/2sBYAuTBvP

## What you can do
- Search publisher listings (DR, price, niche, country, link type)
- Place guest post orders (provided content or publisher-written)
- Track order status, delivery URLs, and messages
- List and manage publisher sites (publishers)
- Check wallet balance and transaction history

## Authentication
1. Register at https://sponsor.ink/register
2. Request API access from Profile (admin approval required)
3. Create a personal access token (prefix `si_`) in Profile
4. Send `Authorization: Bearer YOUR_TOKEN` on every request

Token abilities are scoped by role (advertiser vs publisher). See the API docs for required abilities per endpoint.

## Base URL
https://sponsor.ink/api/v1

## Typical advertiser flow
1. GET /marketplace?min_dr=40&max_price=200&language=en — search listings
2. GET /marketplace/{site} — review one listing (site id is 32-char hex public id)
3. GET /wallet — confirm balance covers the order
4. POST /sites/{site}/orders — place order with target_url, type, brief, content (MCP: confirmed:true required)
5. GET /orders/{order} — poll status until delivered
6. POST /orders/{order}/transition — mark completed or request revision

## Typical publisher flow
1. POST /sites — create a draft listing
2. GET /orders — incoming orders on your sites
3. POST /orders/{order}/transition — accept, deliver with live_url

## Wallet funding
Orders debit the advertiser wallet at placement. Top up via Stripe Checkout at https://sponsor.ink/wallet (web UI only; not available via API).

## Rate limits
- 60 requests/minute for reads
- 20 requests/minute for writes (orders, transitions, site mutations)

## Support
- How it works: https://sponsor.ink/how-it-works
- Contact: https://sponsor.ink/contact