Documentation | LinkSwarm

🐝 The Network Model

LinkSwarm uses a pool model, not direct exchanges:

❌ Old Way (Detectable)

A ↔ B (reciprocal)

Google detects patterns

✅ LinkSwarm (Natural)

A→B, C→A, B→D

Non-reciprocal distribution

🚀 Quick Start

1. Get your API key

# Sign up
POST https://api.linkswarm.ai/waitlist
{"email": "you@yoursite.com"}

# Verify (check email for code)
POST https://api.linkswarm.ai/verify-email
{"email": "you@yoursite.com", "code": "123456"}

# Response includes your API key
{"success": true, "apiKey": "sk_linkswarm_..."}

2. Register & verify your site

# Register
POST https://api.linkswarm.ai/v1/sites
Authorization: Bearer sk_linkswarm_...
{
  "domain": "yoursite.com",
  "name": "Your Site",
  "categories": ["crypto", "fintech"]
}

# Verify ownership (add DNS TXT or meta tag first)
POST https://api.linkswarm.ai/v1/sites/verify
{"domain": "yoursite.com"}

3. Analyze for semantic matching

# Enable AI-powered relevance matching
POST https://api.linkswarm.ai/v1/sites/analyze
{"domain": "yoursite.com"}

# Response
{
  "has_embedding": true,
  "message": "Semantic matching enabled!"
}

4. Contribute to the pool (give links)

# Offer pages where you'll place outbound links
POST https://api.linkswarm.ai/v1/pool/contribute
{
  "domain": "yoursite.com",
  "page": "/blog/resource-guide",
  "max_links": 2,
  "categories": ["crypto", "defi"]
}

5. Request links (get links)

# Request links to your pages
POST https://api.linkswarm.ai/v1/pool/request
{
  "domain": "yoursite.com",
  "target_page": "/products/card",
  "preferred_anchor": "best crypto card"
}

6. Check your status

GET https://api.linkswarm.ai/v1/pool/status

{
  "credits_available": 5,
  "credits_contributed": 8,
  "pending_placements": [...],
  "links_received": [...]
}

🔐 Authentication

All API requests require your API key in the header:

curl -H "Authorization: Bearer sk_linkswarm_your_key" \
  https://api.linkswarm.ai/dashboard

⚠️ Keep your API key secret. Rotate it anytime with POST /rotate-key

📡 API Endpoints

Method	Endpoint	Description
POST	/waitlist	Sign up (public)
POST	/verify-email	Verify email, get API key
GET	/dashboard	Account overview
POST	/rotate-key	Rotate API key
POST	/v1/sites	Register a site
POST	/v1/sites/verify	Verify domain ownership
POST	/v1/sites/analyze	Analyze for semantic matching
GET	/v1/sites	List your sites
GET	/v1/discover	Find matching sites
POST	/v1/pool/contribute	Offer link slots
POST	/v1/pool/request	Request links
GET	/v1/pool/status	Check credits & placements
POST	/v1/pool/triangle	Request 3-way exchange 🔺
GET	/v1/pool/triangles	View your triangles 🔺
GET	/registry	Public site list

🔺 Triangle (3-Way) Exchanges

More valuable than direct reciprocal links because they look more natural to search engines:

Site A → Site B → Site C → Site A

Each site gives one link and receives one link, but never directly reciprocal

# Request a triangle exchange
POST https://api.linkswarm.ai/v1/pool/triangle
Authorization: Bearer sk_linkswarm_xxx

{
  "domain": "your-site.com"
}

# Response
{
  "triangle_id": "abc123",
  "exchange": {
    "your_site": "your-site.com",
    "you_link_to": "partner-b.com",
    "links_to": "partner-c.com", 
    "links_back_to": "your-site.com"
  }
}