SDK (Node.js)

npm install nephia

import { Nephia } from "nephia";

const client = new Nephia({ apiKey: process.env.NEPHIA_API_KEY });

// Everything your queries caught in the last 24 hours, newest first.
const { mentions } = await client.mentions.list({ limit: 50 });

for (const mention of mentions) {
  console.log(mention.source, mention.sentiment, mention.title, mention.url);
}

const query = await client.queries.create({
  name: "figma",
  refreshIntervalSeconds: 900,
  globalCriteria: { market: "fr", terms: ["figma", "figma alternative"] },
  sources: [
    { source: "reddit", enabled: true },
    { source: "x", enabled: true },
  ],
  aiEnabled: true,
  sentimentEnabled: true,
});

const watch = await client.x.watches.create({
  query: "figma",
  refreshIntervalSeconds: 300,
  webhookUrl: "https://example.com/webhooks/nephia",
});

const client = new Nephia({ apiKey: "YOUR_API_KEY" });

// Free: a substring scan over your own stored mentions.
const page = await client.mentions.list({
  since: "2026-08-01T00:00:00.000Z",
  source: "reddit",
  intent: ["purchase_intent", "comparison"],
});

// Charged: searches by meaning instead of by substring.
const semantic = await client.mentions.list({ q: "pricing complaints", mode: "semantic" });

let cursor: string | undefined;
do {
  const page = await client.mentions.list({ cursor, limit: 100 });
  handle(page.mentions);
  cursor = page.nextCursor;
} while (cursor);

const { queries } = await client.queries.list();
const detail = await client.queries.get(queries[0].id);

// Mentions scoped to one query, carrying the bucket each was sorted into.
const { mentions } = await client.queries.listResults(detail.id, { limit: 50 });

// A patch: a key you leave out is left alone; `null` clears it.
const { query, resetSearches } = await client.queries.update(detail.id, {
  refreshIntervalSeconds: 1800,
});

await client.x.watches.list();
await client.x.watches.get(watch.id);
await client.x.watches.pause(watch.id);
await client.x.watches.resume(watch.id);
await client.x.watches.listEvents(watch.id, { since: "2026-07-01T00:00:00.000Z" });
await client.x.watches.delete(watch.id);

import { Nephia } from "nephia";

const ok = await Nephia.webhooks.verify(rawBody, req.headers["x-signature"], secret);