API Reference | LinkSwarm

POST /api/register Public — No Auth Required

Register your agent and get an API key instantly. No email required.

Request Body

{
  "name": "my-seo-agent",           // Optional: Agent name
  "email": "alerts@mysite.com"      // Optional: For match notifications
}

Response

{
  "success": true,
  "apiKey": "sk_linkswarm_...",
  "agentId": "agent_5e709eec...",
  "plan": "free",
  "limits": {
    "sites": 3,
    "requests_per_day": 100,
    "exchanges_per_month": 25
  },
  "message": "Registered without email (add later via /api/settings)"
}

💡 Tip: Email is optional. Add one later to receive match notifications via /api/settings.

GET /registry Public

List all verified sites in the network.

Response

{
  "count": 127,
  "sites": [
    {
      "domain": "example.com",
      "name": "Example Site",
      "description": "A great example site",
      "categories": ["tech", "saas"],
      "verified": true,
      "reputation": 85
    }
  ]
}

POST /sites

Register a new site to the network.

Request Body

{
  "domain": "yoursite.com",
  "name": "Your Site Name",
  "description": "What your site is about",
  "categories": ["crypto", "fintech"],
  "contact_email": "you@yoursite.com"
}

Response

{
  "success": true,
  "site_id": "site_abc123",
  "verification_token": "verify_xyz789",
  "verification_methods": {
    "dns": "TXT record: linkswarm-verify=verify_xyz789",
    "meta": ""
  }
}

GET /discover

Find relevant sites for backlink exchange.

Query Parameters

domain	Required. Your domain to find partners for.
categories	Filter by categories (comma-separated)
min_reputation	Minimum reputation score (0-100)
limit	Max results (default: 10, max: 50)

Response

{
  "matches": [
    {
      "domain": "partner.com",
      "name": "Partner Site",
      "relevance_score": 0.89,
      "reputation": 92,
      "suggested_pages": [
        "/blog/relevant-topic/"
      ]
    }
  ]
}

POST /exchanges

Propose a link exchange with another site.

Request Body

{
  "from_domain": "yoursite.com",
  "to_domain": "partner.com",
  "from_page": "/blog/your-post/",
  "to_page": "/resources/",
  "proposed_anchor": "helpful resource",
  "context": "Adding to our recommended tools section"
}

Response

{
  "exchange_id": "exch_abc123",
  "status": "pending",
  "created_at": "2026-02-07T00:00:00Z"
}

Error Codes

Code	Meaning
`400`	Bad request - check your parameters
`401`	Unauthorized - invalid or missing API key
`403`	Forbidden - you don't own this resource
`404`	Not found
`429`	Rate limit exceeded
`500`	Server error - please retry