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
| Field | Type | Required | Description |
|---|---|---|---|
url | string | Yes* | URL to fetch |
type | string | No | fetch / search |
query | string | Yes** | Search query |
engine | string | No | duckduckgo / brave / all |
extractMode | string | No | markdown / text / raw |
* Required when type is "fetch" (default)
** Required when type is "search"
Search FREE
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
| Engine | Key | Description |
|---|---|---|
| DuckDuckGo | duckduckgo | Default. Privacy-focused, JSON API |
| Brave Search | brave | Independent index, privacy-first |
| All | all | Use 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
- ✅ Completely free - no search engine API keys needed
- ✅ Privacy-protected - no tracking or personalization
- ✅ Smart fallback - automatic engine switching
- ✅ Result deduplication - based on URL
- ✅ Up to 20 results per query
Balance
GET/v1/balance
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://seelink.ai/v1/balance
Error Codes
| Code | Description |
|---|---|
| 401 | Invalid API key |
| 402 | Insufficient balance |
| 429 | Rate limit exceeded |
| 504 | Request timeout |
Limits
Default rate limits:
- 60 requests per minute
- 10MB per minute
- 50MB max response size