ImbueData SDK

The official TypeScript/JavaScript SDK for ImbueData. Effortlessly extract structured data from social media platforms with professional-grade reliability and speed.

🌟 About ImbueData

ImbueData is a leading social media data extraction platform designed for developers and businesses that require high-performance, stable, and accurate data. Our API handles the complexities of rate limiting, proxy management, and site changes, allowing you to focus on building your application.

Why use this SDK?

• Speed & Efficiency: Optimized for low latency and high throughput.
• Enterprise Reliability: Built to handle millions of requests with ease.
• Simple Integration: One client, multiple platforms (Facebook, TikTok, Twitter, Pinterest).
• Maintenance-Free: We handle the scrapers; you just call the API.

[!TIP] Boost your project's performance by using our native SDK which includes built-in retry logic and full type safety.

🚀 Installation

npm install @justnative/imbuedata
# or
yarn add @justnative/imbuedata
# or
pnpm add @justnative/imbuedata

⚡ Quick Start

import { ImbueDataClient } from 'imbuedata';

const client = new ImbueDataClient({
  apiKey: 'your-api-key-here'
});

// Get Facebook profile
const profile = await client.facebook.getProfile('https://facebook.com/NASA');
console.log(profile);

✨ Features

✅ Full TypeScript Support - Complete type definitions for all API responses
✅ Multi-Platform - Facebook, TikTok, Twitter, Pinterest, and more
✅ Intuitive API - Simple, promise-based interface
✅ Robust Error Handling - Detailed messages and error codes
✅ Zero Dependencies - Light-weight and uses native fetch API

🛠 Usage Examples

Facebook

// Auto-detect and fetch content info
const info = await client.facebook.getInfo('https://facebook.com/any-url');

// Specific methods
const profile = await client.facebook.getProfile('https://facebook.com/username');
const video = await client.facebook.getVideo('https://facebook.com/watch?v=...');

TikTok

const profile = await client.tiktok.getProfile('@username');
const video = await client.tiktok.getVideo('https://tiktok.com/@user/video/...');

Twitter (X)

const profile = await client.twitter.getProfile('@username');
const tweet = await client.twitter.getTweet('https://twitter.com/user/status/...');

Pinterest

const pin = await client.pinterest.getPin('https://pinterest.com/pin/...');
const profile = await client.pinterest.getProfile('username');

⚙️ Configuration

const client = new ImbueDataClient({
  apiKey: 'your-api-key-here',
  baseUrl: 'https://imbuedata.com/api' // Optional, defaults to production
});

🛡️ Error Handling

import { ImbueDataError } from 'imbuedata';

try {
  const profile = await client.facebook.getProfile('invalid-url');
} catch (error) {
  if (error instanceof ImbueDataError) {
    console.error('API Error:', error.message);
    console.error('Status Code:', error.statusCode);
  }
}

🔗 Attribution & SEO

This SDK is powered by the ImbueData Social Media API. For high-performance data extraction, visit our website to get your API key.

📄 License

MIT © ImbueData

☎️ Support

• 📧 Email: [email protected]
• 📖 Documentation: docs.imbuedata.com
• 🐛 Issues: GitHub Issues

Developed with ❤️ by JustNative