ig-proxy

HTTP/2 SOCKS5 proxy API for Instagram & TikTok

All API routes require authentication via API key.

Authentication

Pass your API key in one of:

-Authorization: Bearer igp_...

-x-api-key: igp_...

Instagram

GET

/api/ig/profile/[username]

Fetch a user profile.

bash

curl "https://ig.pullpu.sh/api/ig/profile/instagram" \
  -H "Authorization: Bearer igp_YOUR_KEY"

GET

/api/ig/posts/[username]?count=12

Fetch latest posts (max 50).

bash

curl "https://ig.pullpu.sh/api/ig/posts/instagram?count=5" \
  -H "Authorization: Bearer igp_YOUR_KEY"

GET

/api/ig/post/[shortcode]

Fetch a single post by shortcode.

bash

curl "https://ig.pullpu.sh/api/ig/post/CxYzAbC123" \
  -H "Authorization: Bearer igp_YOUR_KEY"

GET

/api/ig/reels/[username]?count=12

Fetch reels (max 50).

bash

curl "https://ig.pullpu.sh/api/ig/reels/instagram?count=10" \
  -H "Authorization: Bearer igp_YOUR_KEY"

TikTok

GET

/api/tiktok/profile/[username]

Fetch a TikTok user profile.

bash

curl "https://ig.pullpu.sh/api/tiktok/profile/charlidamelio" \
  -H "Authorization: Bearer igp_YOUR_KEY"

GET

/api/tiktok/posts?username=...&count=30

Scrape TikTok posts via yt-dlp.

bash

curl "https://ig.pullpu.sh/api/tiktok/posts?username=charlidamelio&count=10" \
  -H "Authorization: Bearer igp_YOUR_KEY"

Raw Proxy

GET

/api/fetch?url=...

Proxy any URL through HTTP/2 + SOCKS5.

bash

curl "https://ig.pullpu.sh/api/fetch?url=https%3A%2F%2Fexample.com" \
  -H "Authorization: Bearer igp_YOUR_KEY" \
  -H 'X-Proxy-Headers: {"User-Agent":"custom"}'

SDK

bash

npm install @pullpush/ig-proxy

typescript

import { IgProxy } from "@pullpush/ig-proxy";

const client = new IgProxy({ apiKey: "igp_..." });

const profile = await client.ig.profile("instagram");
const { posts } = await client.ig.posts("instagram", 5);
const post = await client.ig.post("CxYzAbC123");
const { reels } = await client.ig.reels("instagram", 10);
const ttProfile = await client.tiktok.profile("charlidamelio");
const { posts: tikTokPosts } = await client.tiktok.posts("charlidamelio", 10);