TypeScript SDK for NewsCatcher News API v3

import { Newscatcher } from "newscatcherapi-typescript-sdk";

const newscatcher = new Newscatcher({
  apiKey: "YOUR_API_KEY",
});

// Regular search
const searchResults = await newscatcher.search.get({
  q: "technology",
  lang: "en",
  includeNlpData: true, // optional, adds NLP analysis layer
});

// Clustered search
const clusterResults = await newscatcher.search.get({
  q: "AI technology",
  lang: "en",
  clusteringEnabled: true,
  clusteringThreshold: 0.6,
  includeNlpData: true,
});

const headlines = await newscatcher.latestHeadlines.get({
  lang: "en",
  countries: "US",
  clusteringEnabled: true,
  includeNlpData: true,
});

const authorArticles = await newscatcher.authors.get({
  authorName: "Sam Altman",
  includeNlpData: true,
});

const similar = await newscatcher.searchSimilar.get({
  q: "SpaceX launch",
  includeNlpData: true,
});

const sources = await newscatcher.sources.get({
  lang: "en",
});

const subscription = await newscatcher.subscription.get();

try {
  const response = await newscatcher.search.get({
    q: "tech news",
  });
} catch (error) {
  if (error instanceof NewscatcherError) {
    console.error(`Status: ${error.status}`);
    console.error(`Message: ${error.message}`);
    console.error(`Response Body:`, error.responseBody);
  }
}

async function withRetry<T>(
  operation: () => Promise<T>,
  maxRetries = 3,
  delay = 1000
): Promise<T> {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await operation();
    } catch (error) {
      if (
        error instanceof NewscatcherError &&
        error.status === 429 &&
        i < maxRetries - 1
      ) {
        await new Promise((resolve) =>
          setTimeout(resolve, delay * Math.pow(2, i))
        );
        continue;
      }
      throw error;
    }
  }
  throw new Error("Max retries exceeded");
}

async function getAllResults(
  newscatcher: Newscatcher,
  query: string,
  maxPages = 5
) {
  const results = [];

  for (let page = 1; page <= maxPages; page++) {
    const response = await newscatcher.search.get({
      q: query,
      page,
      pageSize: 100,
    });

    const data = response.data;
    if ("clusters" in data && Array.isArray(data.clusters)) {
      data.clusters.forEach((cluster) => {
        if (cluster.articles) {
          results.push(...cluster.articles);
        }
      });
    } else if ("articles" in data) {
      results.push(...data.articles);
    }

    if (page >= data.total_pages) break;
  }

  return results;
}