NG 개발자

빠른 시작

몇 초 만에 NG API를 시작하세요. 모든 공개 엔드포인트는 인증이 필요하지 않습니다.

# Search sites
curl https://ng.net/api/sites?search=AI+tools

# Get trending
curl https://ng.net/api/sites?sort=hot

# Submit a URL
curl -X POST https://ng.net/api/sites \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Get chat messages
curl https://ng.net/api/messages?limit=10

# Send a message
curl -X POST https://ng.net/api/messages \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello from the API!"}'

API 참조

모든 엔드포인트는 JSON을 사용합니다. 기본 URL: https://ng.net

{
  "sites": [{ "id": "abc123", "url": "https://example.com", "title": "Example", ... }],
  "total": 42,
  "page": 1,
  "hasMore": true
}

{
  "url": "https://example.com",        // required
  "turnstileToken": "cf-..."    // required when CAPTCHA enabled
}

{ "site": { ... }, "isNew": true }

{ "site": { ... }, "isNew": false }

400 — Invalid URL or request format
403 — Missing or invalid Turnstile token
429 — Rate limited (5/min per IP)

{ "tags": ["工具", "技术", "设计", "新闻", "社区", ...] }

{ "site": { ... }, "credits": 0 }

404 — Site not found
429 — Daily limit reached (1/day free, 3/day logged-in)

{ "site": { ... }, "verified": true }

400 — Verification meta tag not found / already claimed
404 — Site not found

{ "recorded": true }

{
  "messages": [{
    "id": "abc", "type": "chat",
    "content": "Hello!", "sender_name": "user123",
    "created_at": "2026-03-27T12:00:00Z"
  }]
}

{ "content": "Hello from the API!" }

{ "message": { "id": "...", "type": "chat", ... } }

400 — Empty or exceeds 200 chars
429 — Rate limited (10/min per IP)

{
  "text": "Hello world",       // max 2000 chars
  "targetLang": "zh-CN"
}

{ "translated": "你好世界" }

400 — Missing params or text too long
429 — Rate limited (20/min per IP)
500 — AI translation failed

{
  "imageUrl": "https://www.bing.com/...",
  "videoUrl": "https://...",  // or null
  "copyright": "Photo credit...",
  "title": "Image title"
}

{ "email": "user@example.com" }

{ "sent": true }

{ "email": "user@example.com", "code": "123456" }

{ "user": { "id": "...", "email": "...", "username": "..." } }

{ "bookmarks": [{ "site_id": "...", "created_at": "..." }] }

데이터 모델

API가 반환하는 핵심 데이터 구조.

Site

ChatMessage

WebSocket API

WebSocket 엔드포인트에 연결하여 실시간 업데이트를 받으세요.

연결

// Browser
const ws = new WebSocket("wss://ng.net/api/ws");

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(data.event, data.payload);
};

이벤트 유형

예제

// new_message event payload
{
  "event": "new_message",
  "payload": {
    "id": "abc123",
    "type": "entrance",
    "content": "entered",
    "content_key": "chat.entered",
    "sender_name": "United States Dallas",
    "sender_location": "US|Dallas",
    "created_at": "2026-03-27T12:00:00Z"
  }
}

// site_update event payload
{
  "event": "site_update",
  "payload": {
    "id": "xyz789",
    "title": "Example Site",
    "description": "A great website",
    "tags": ["工具", "技术"]
  }
}

// like event payload
{
  "event": "like",
  "payload": {
    "messageId": "msg123",
    "fromUser": "United States Dallas",
    "toUser": "Japan Tokyo"
  }
}

인증

대부분의 엔드포인트는 공개입니다. 일부 기능은 이메일 로그인이 필요합니다.

로그인 흐름

1. 이메일로 인증 코드 전송

curl -X POST https://ng.net/api/auth/send-code \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

2. 코드 확인 및 세션 획득

curl -X POST https://ng.net/api/auth/verify \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "code": "123456"}'

인증 필요 엔드포인트

AI 기능

NG는 Cloudflare Workers AI로 지능형 기능을 제공합니다.

자동 태깅

URL 제출 시 AI가 콘텐츠를 분석하고 자동으로 카테고리 태그를 할당합니다.

사용 가능한 태그

번역

번역 API는 12개 언어를 지원합니다. 소스 언어는 자동 감지됩니다.

지원 언어

소셜 프로필 감지

소셜 플랫폼의 URL은 자동 감지되어 프로필 카드로 표시됩니다.

지원 플랫폼

URL 패턴 매칭으로 감지합니다.

프로필 전용 필드

사이트 소유권 인증

사이트 소유자는 소유권을 확인하여 분석 및 프리미엄 표시 등의 기능을 이용할 수 있습니다.

확인 단계

1. ng.net에서 사이트를 찾고 ID 기록

2. 사이트 HTML에 meta 태그 추가

<meta name="ngnet-verify" content="YOUR_SITE_ID">

3. 인증 API 호출

curl -X POST https://ng.net/api/sites/YOUR_SITE_ID/claim

인증 혜택

• 인증 배지 표시
• 클릭 분석 접근
• 검색 결과 우선 표시
• 설명 및 태그 관리

속도 제한

속도 제한은 IP 주소별로 적용됩니다.

CLI 도구

NG 공유 플랫폼 공식 CLI 도구.

설치

# Install globally
npm install -g @ngnet/cli

# Or use directly with npx
npx ngnet help

명령어

전역 옵션

예제

# Search for AI tools
ngnet search "AI tools"

# Get trending sites as JSON
ngnet trending --json

# Filter by tag
ngnet tag 技术

# Submit a site
ngnet submit https://example.com

# Boost a site
ngnet boost abc123

# Translate text
ngnet translate "Hello world" --to ja

# Send chat message
ngnet send "Hello from CLI!"

# Pipe JSON output to jq
ngnet search "design" --json | jq '.sites[].title'

코드 예제

인기 언어별 통합 패턴.

사이트 검색

curl -s "https://ng.net/api/sites?search=AI+tools&sort=hot" | jq .

const res = await fetch('https://ng.net/api/sites?search=AI+tools');
const { sites, total } = await res.json();
console.log(`Found ${total} sites`);
sites.forEach(s => console.log(s.title, s.url));

import requests

r = requests.get("https://ng.net/api/sites", params={"search": "AI tools"})
data = r.json()
for site in data["sites"]:
    print(site["title"], site["url"])

URL 제출

curl -X POST https://ng.net/api/sites \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

const res = await fetch('https://ng.net/api/sites', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ url: 'https://example.com' })
});
const { site, isNew } = await res.json();
console.log(isNew ? 'New!' : 'Already exists', site.title);

import requests

r = requests.post("https://ng.net/api/sites", json={"url": "https://example.com"})
data = r.json()
print("New!" if data["isNew"] else "Exists", data["site"]["title"])

WebSocket 실시간

// Browser WebSocket client
const ws = new WebSocket("wss://ng.net/api/ws");

ws.onopen = () => console.log("Connected!");

ws.onmessage = (event) => {
  const { event: type, payload } = JSON.parse(event.data);
  switch (type) {
    case "new_message":
      console.log(`[${payload.sender_name}] ${payload.content}`);
      break;
    case "site_update":
      console.log(`Site updated: ${payload.title}`);
      break;
    case "like":
      console.log(`${payload.fromUser} liked a message`);
      break;
  }
};

ws.onclose = () => console.log("Disconnected");

변경 로그

API 버전 이력.

디스커버리 엔드포인트

AI 에이전트와 자동화 도구를 위한 기계 판독 가능 엔드포인트.