Documentation

Everything you need to integrate SeeLink into your AI agent.

Quick Start

Make your first request in 30 seconds.

Option 1: Install SDK (Recommended)

npm install @seelink/sdk
import { SeeLink } from '@seelink/sdk';

const client = new SeeLink({
  apiKey: 'YOUR_API_KEY' // or SEELINK_API_KEY env var
});

const result = await client.fetch('https://x.com', {
  extractMode: 'markdown'
});

console.log(result.content);

Option 2: REST API (No Installation)

POSThttps://seelink.ai/v1/fetch
curl -X POST https://seelink.ai/v1/fetch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://x.com"}'

Response

{
  "success": true,
  "data": {
    "url": "https://x.com",
    "status": 200,
    "content": "...",
    "metadata": {
      "bytes": 236632,
      "latency": "130ms",
      "cost": "0.002257"
    }
  }
}

Authentication

All API requests require an API key in the Authorization header:

Authorization: Bearer sk_live_xxxxxxxxxxxx

Get your API key from the Console.

Fetch

POST/v1/fetch

Parameters

FieldTypeRequiredDescription
urlstringYes*URL to fetch
typestringNofetch / search
querystringYes**Search query
enginestringNoduckduckgo / brave / all
extractModestringNomarkdown / text / raw

* Required when type is "fetch" (default)
** Required when type is "search"

Built-in search functionality powered by DuckDuckGo and Brave Search. No API key required for search engines.

Basic Search

curl -X POST https://seelink.ai/v1/fetch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "search", "query": "AI trends 2026"}'

Response

{
  "success": true,
  "type": "search",
  "query": "AI trends 2026",
  "engines": ["duckduckgo"],
  "data": {
    "results": [
      {
        "title": "Top AI Trends in 2026",
        "url": "https://example.com/ai-trends",
        "description": "Explore the latest AI trends...",
        "engine": "duckduckgo"
      }
    ],
    "total": 15
  }
}

Search Engines

EngineKeyDescription
DuckDuckGoduckduckgoDefault. Privacy-focused, JSON API
Brave SearchbraveIndependent index, privacy-first
AllallUse both engines, aggregate results

Multi-Engine Search

curl -X POST https://seelink.ai/v1/fetch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "search", "query": "AI trends", "engine": "all"}'

Features

Balance

GET/v1/balance
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://seelink.ai/v1/balance

Error Codes

CodeDescription
401Invalid API key
402Insufficient balance
429Rate limit exceeded
504Request timeout

Limits

Default rate limits: