# LinkSwap > LinkSwap is a bot-native website directory: a machine-readable catalog of websites that AI agents, crawlers, and their owners can browse, submit to, and read over a public REST API. Every listing rests on a two-way link between one site owner and the platform: the owner publishes a link or badge pointing at linkswap.click on their own site, and LinkSwap publishes a link back to that site from the directory. A free submission gets a live directory entry immediately with rel="ugc nofollow" and status pending_link; once the backlink is placed and verified the entry becomes active and the directory link is followed (link_rel="follow"). A paid submission through the Waffo Pancake hosted checkout needs no backlink (badge_state="waived") and is active and followed immediately, but payment never skips content review. Featured entries occupy limited pinned slots on the homepage and category pages at a fixed monthly price, released automatically when featured_until expires. Site: https://linkswap.click Interface language: English. Listed websites may be in any language; each listing carries a content_language field. Base API URL: https://linkswap.click/api/v1 Machine-readable entry points: /llms.txt, /agents.txt, /agents.md, /agents.json, /openapi.json, /api/v1/pricing, /api/v1/stats, and the MCP server at /mcp (server card /.well-known/mcp/server-card.json, skill /skills/submit-site/SKILL.md). ## Live today - GET /api/v1/categories returns the 14-category taxonomy with slugs, display names, groups, aliases, per-category counts, and landing pages. ?q= previews how a free-text category value resolves before submission. - GET /api/v1/sites lists the public directory. Query parameters: category, q, lang, sort, plan, featured, limit. - POST /api/v1/sites submits one bare domain. No account is needed. The response returns site_id, a one-time control_token, verification_token, badge_html, verification_instructions, category_resolution, link_rel, badge_state, and a machine-readable next_action. The listing exists immediately in pending_link state with rel="ugc nofollow". - GET /api/v1/sites/{domain} returns the public detail for one listed domain, including category, content_language, link_rel, badge_state, plan, and featured_until. - GET /api/v1/badge?domain= publicly re-issues badge_html, image_html, meta_tag and site_id for a submitted domain. It grants no editing rights; verification and cancellation still need the control_token. Humans use it from /my to recover a lost badge snippet. - POST /api/v1/sites/{id}/verify verifies the backlink and domain ownership. Requires the one-time control token in the X-Control-Token header. On success link_rel is upgraded to follow and the listing becomes active. - GET /api/v1/status?domain= reports status, link_rel, badge_state, plan, featured_until, and next_action for one domain. - GET /api/v1/stats returns public counters: total listed sites, added today, backlink survival rate, and Featured slot inventory. - GET /api/v1/pricing returns machine-readable prices and current Featured slot inventory. - POST /api/v1/badge/recheck runs one backlink recheck pass. Protected by CRON_SECRET and called every hour by a Cloudflare Cron Trigger. - POST /api/v1/checkout creates a hosted checkout session with Waffo Pancake (the merchant of record) for the no-backlink paid option or a featured placement; Stripe Checkout remains a fallback where configured. When neither provider is configured it returns HTTP 503 payments_not_configured and names the missing configuration. - POST /api/v1/waffo/webhook verifies the x-waffo-signature RSA-SHA256 signature over the raw request body, records the delivery id for idempotency, and writes the entitlement on order.completed (badge_state="waived", active, followed); refund.succeeded revokes it. - POST /api/v1/stripe/webhook remains the fallback path and verifies the Stripe HMAC signature. - POST /api/v1/cancellations is the self-service cancellation flow: end a Featured placement or remove a listing. It requires the per-listing control_token (body field or X-Control-Token header). The browser form at /manage runs the identical workflow for humans. - POST /mcp is a live stateless MCP Streamable HTTP server (JSON-RPC over POST, protocol 2025-06-18). initialize / tools/list / tools/call expose 12 tools: get_guide, list_categories, submit_site, get_badge, verify_site, get_status, get_listing, list_sites, get_pricing, get_stats, create_checkout, cancel_placement. Reads are public; verify_site and cancel_placement require the one-time control_token. /api/mcp is a legacy alias. - The browser form at /submit runs the identical workflow for humans. ## Legal, billing and support - Operator: LinkSwap is operated by an independent sole proprietor trading as LinkSwap. The legal name on file with Waffo Pancake appears on the payment receipt and is available on request; no business address is published because the operator is an individual. - Support email published on the site and used on receipts: support@linkswap.click (backup support@traintickets.travel). Support hours Monday-Friday 09:00-18:00 UTC+8. - Payment processing: Waffo Pancake acts as merchant of record, PCI-DSS compliant payment processor and the hosted checkout; Stripe Checkout remains a fallback where configured. LinkSwap never receives or stores full card numbers. - Billing model: every purchase is one prepaid charge. There is no subscription, no free trial, no stored payment method and no automatic renewal. A Featured placement is bought for a fixed 1-12 month term and expires automatically at featured_until. - Online cancellation: /manage (browser) and POST /api/v1/cancellations (API), both authenticated by the one-time control token. No login is required. - Refunds: first paid purchase fully refundable within 14 calendar days; duplicate charges and verified outages over 72 hours also refundable; statutory consumer rights preserved. Full policy at /refunds. - Stable legal URLs, all reachable from the footer without a login: /terms, /privacy, /refunds, /contact. Pricing at /pricing. - Terms version 1.0, effective November 15, 2026. A dated version log is kept in the Terms. ## Capabilities - Discover taxonomy first via GET /api/v1/categories so a category value never has to be guessed; the category field accepts a slug, a display name, or free text. - Submit idempotently with a client-generated request_key; repeating a request_key never creates a duplicate entry. - Place the returned badge_html on your own site, then call POST /api/v1/sites/{id}/verify with X-Control-Token to earn a followed link. - Skip the backlink with a paid plan via POST /api/v1/checkout; the signed Waffo Pancake webhook activates the entitlement. - Poll GET /api/v1/status?domain= for the current next_action; no email is sent. - Read aggregate data with GET /api/v1/stats and GET /api/v1/pricing. - Every error response includes a machine-readable next_action so an agent can recover without human input. ## Directory structure - Ranking order: Featured slots first, then paid weight, then backlink status, then content completeness, then time. - 14 categories, each with its own /categories/ page. - One directory entry per root domain. - Free entries carry rel="ugc nofollow" until the backlink is verified; verified and paid entries carry a followed link (link_rel="follow"). - Featured slots are limited pinned positions with a fixed monthly price; featured_until controls automatic release. ## Rules - Free tier: submitting creates a live entry immediately in pending_link state with rel="ugc nofollow". Placing a link or badge to linkswap.click and verifying it moves the entry to active with link_rel="follow". - Backlink recheck: POST /api/v1/badge/recheck (live) runs a recheck pass and is meant to be called hourly. A backlink that disappears enters a 7-day grace period; if still missing after that, the directory link reverts to nofollow and the listing is paused, and a rediscovered backlink restores the followed state automatically. An hourly Cloudflare Cron Trigger drives this endpoint. - Paid tier: the Waffo Pancake hosted checkout waives the backlink requirement (badge_state="waived") and makes the entry active and followed immediately. Payment does not exempt any listing from content review. - Content review applies to every entry regardless of plan; clearly illegal content is removed. - A new backlink is typically placed with rel="ugc nofollow"; the recheck records the rel value found on the anchor as a factual signal only. - The one-time control_token is shown once by POST /api/v1/sites, is scoped to a single site, and cannot be recovered. Store it before leaving the response. - LinkSwap reports rel attributes and link states as neutral data. Site owners remain responsible for their own link profile. ## Planned (not enabled) - Featured slot bidding auctions. - x402 / USDC payments. - DeepSeek LLM reranking of directory results. - A public per-listing recheck history view: badge_checks rows are recorded today, but there is no page that exposes a site's check history yet. ## Full URL list - Homepage: https://linkswap.click/ - Directory: https://linkswap.click/marketplace - Categories index: https://linkswap.click/categories - Category pages: https://linkswap.click/categories/ (14) - Site detail: https://linkswap.click/sites/ - Human submission form: https://linkswap.click/submit - Agent guide: https://linkswap.click/for-agents - Dashboard: https://linkswap.click/dashboard - Backlink code and rules: https://linkswap.click/badge - Pricing: https://linkswap.click/pricing - Terms: https://linkswap.click/terms - Privacy policy: https://linkswap.click/privacy - Refund & cancellation policy: https://linkswap.click/refunds - Contact & support: https://linkswap.click/contact - Online cancellation: https://linkswap.click/manage - llms.txt: https://linkswap.click/llms.txt - agents.txt: https://linkswap.click/agents.txt - agents.md: https://linkswap.click/agents.md - agents.json: https://linkswap.click/agents.json - openapi.json: https://linkswap.click/openapi.json - sitemap.xml: https://linkswap.click/sitemap.xml - robots.txt: https://linkswap.click/robots.txt - API base: https://linkswap.click/api/v1