NG Desarrolladores

Inicio rápido

Comienza con la API de NG en segundos. Todos los endpoints públicos no requieren autenticación.

# 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!"}'

Referencia API

Todos los endpoints usan JSON. URL base: 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": "..." }] }

Modelos de datos

Estructuras de datos principales.

Site

ChatMessage

API WebSocket

Conéctate al endpoint WebSocket para actualizaciones en tiempo real.

Conexión

// 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);
};

Tipos de eventos

Ejemplo

// 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"
  }
}

Autenticación

La mayoría son públicos. Algunas funciones requieren inicio de sesión por email.

Flujo de inicio de sesión

1. Enviar código de verificación al email

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

2. Verificar código y obtener sesión

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

Endpoints protegidos

Funciones IA

NG usa Cloudflare Workers AI para funciones inteligentes.

Etiquetado automático

Al enviar una URL, la IA analiza el contenido y asigna etiquetas automáticamente.

Etiquetas disponibles

Traducción

La API de traducción soporta 12 idiomas con detección automática del idioma origen.

Idiomas soportados

Detección de perfiles sociales

Las URLs de plataformas sociales se detectan automáticamente y se muestran como tarjetas de perfil.

Plataformas soportadas

Detección basada en patrones de URL.

Campos específicos de perfil

Reclamar propiedad

Los propietarios pueden verificar la propiedad para desbloquear funciones adicionales.

Pasos de verificación

1. Encuentra tu sitio en ng.net

2. Añade una etiqueta meta al HTML

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

3. Llama al endpoint de reclamación

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

Beneficios

• Insignia verificada
• Análisis de clics
• Prioridad en búsquedas
• Gestionar descripción y etiquetas

Límites de velocidad

Los límites se aplican por dirección IP.

Herramienta CLI

Herramienta CLI oficial para la Plataforma NG Share.

Instalación

# Install globally
npm install -g @ngnet/cli

# Or use directly with npx
npx ngnet help

Comandos

Opciones globales

Ejemplos

# 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'

Ejemplos de código

Patrones de integración comunes.

Buscar sitios

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"])

Enviar 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 tiempo real

// 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");

Registro de cambios

Historial de versiones de la API.

Endpoints de descubrimiento

Puntos de entrada legibles por máquina para agentes AI.