omniscrape 0.4.0

Python SDK for the Omniscrape social media data API

Omniscrape Python SDK

The official Python SDK for the Omniscrape social media data API.

Supports Threads, Facebook, X (Twitter), Instagram, Reddit, LinkedIn, TikTok, YouTube, Dcard, Google Maps, and 104.

Installation

pip install omniscrape

Quick Start

from omniscrape import Omniscrape

client = Omniscrape(api_key="sk_oms_...")

# Get a Threads post
post = client.threads.get_post("DQt-ox3kdE4")
print(post.data.text)
print(post.data.stats.likes)

Platform Examples

Threads

# User profile
user = client.threads.get_user("zuck")
print(f"{user.data.username} — {user.data.follower_count} followers")

# Search posts
results = client.threads.search_posts("AI")

X (Twitter)

user = client.x.get_user("elonmusk")
tweet = client.x.get_post("1234567890")

# Auto-paginate all posts
for post in client.x.iter_user_posts("elonmusk"):
    print(post.text)

Instagram

user = client.instagram.get_user("instagram")
print(user.data.follower_count)

TikTok

video = client.tiktok.get_video("7123456789")
user = client.tiktok.get_user("khaby.lame")

# Browse trending
trending = client.tiktok.get_categories()

Reddit

sub = client.reddit.get_subreddit("python")
posts = client.reddit.get_subreddit_posts("python", sort="hot")

LinkedIn

company = client.linkedin.get_company("google")
jobs = client.linkedin.search_jobs(query="software engineer", location="Taiwan")

# Auto-paginate jobs
for job in client.linkedin.iter_search_jobs(query="data scientist"):
    print(job.title, job.location)

YouTube

video = client.youtube.get_video("dQw4w9WgXcQ")
channel = client.youtube.get_channel("@mkbhd")
results = client.youtube.search("machine learning", count=5)
transcript = client.youtube.get_video_transcription("dQw4w9WgXcQ", language="en")

Dcard

forum = client.dcard.get_forum("trending")
posts = client.dcard.get_forum_posts("trending", limit=10, popular=True)
results = client.dcard.search_posts("台大", limit=10)

Google Maps

results = client.gmaps.search("coffee shops in Tokyo", language="en")
place = client.gmaps.get_place("Blue Bottle Coffee Tokyo")

Facebook

page = client.facebook.get_user("NASA")
posts = client.facebook.get_user_posts("NASA")

104 Jobs

jobs = client.job104.search_jobs(q="Python工程師")
company = client.job104.get_company("company_id")

Async Support

import asyncio
from omniscrape import AsyncOmniscrape

async def main():
    async with AsyncOmniscrape(api_key="sk_oms_...") as client:
        post = await client.threads.get_post("DQt-ox3kdE4")
        print(post.data.text)

asyncio.run(main())

Rate Limit & Credit Info

Every response includes rate limit and credit usage:

resp = client.threads.get_post("DQt-ox3kdE4")
print(resp.rate_limit.remaining)  # requests left
print(resp.credit.remaining)      # credits left

Error Handling

from omniscrape import Omniscrape, NotFoundError, RateLimitError

try:
    client.threads.get_post("invalid")
except NotFoundError:
    print("Post not found")
except RateLimitError as e:
    print(f"Rate limited, retry after {e.retry_after}s")

Environment Variable

You can set your API key as an environment variable instead of passing it directly:

export OMNISCRAPE_API_KEY="sk_oms_..."

client = Omniscrape()  # picks up from env

Links

• Website
• GitHub