@supacrawlx/sdk

Official Node.js / TypeScript SDK for SupaCrawlX — extract transcripts, metadata, and structured data from YouTube, TikTok, Instagram, X (Twitter), Facebook, and any web URL.

Install

npm i @supacrawlx/sdk

Requires Node 18+. Ships with full TypeScript types and uses native fetch (no extra dependencies).

Quickstart

import { Client } from '@supacrawlx/sdk'

const client = new Client('YOUR_API_KEY')

// Universal transcript (auto-detects the platform from the URL)
const transcript = await client.transcript('https://youtu.be/dQw4w9WgXcQ')
console.log(transcript.content)

// Metadata for any supported URL
const meta = await client.metadata('https://youtu.be/dQw4w9WgXcQ')

Resource groups

client.youtube — transcript, search, channel, playlist, batch
client.web — scrape, crawl, map
client.video — analyze
client.jobs — poll async jobs (e.g. crawls)
client.transcript(url, options) / client.metadata(url) — universal helpers

Configuration

const client = new Client('YOUR_API_KEY', {
  baseUrl: 'https://api.supacrawlx.com', // default
  timeout: 30_000,                       // ms
})

Error handling

import { Client, APIError } from '@supacrawlx/sdk'

try {
  await client.transcript('https://youtu.be/bad')
} catch (err) {
  if (err instanceof APIError) console.error(err.message)
}

Full reference: https://supacrawlx.com/docs

License: MIT