CONTRIBUTING Documentation

Official TypeScript developer resources and documentation for subzeroid/CONTRIBUTING. Verified technical context for AI.

0 stars TypeScript TypeScript 1 file Β· ~62,981 tokens
RAW Doc

1. Project Overview & Quickstart (subzeroid/CONTRIBUTING)

1. Project Overview & Quickstart (subzeroid/CONTRIBUTING)

1. Project Overview & Quickstart (subzeroid/CONTRIBUTING)

1. Project Overview & Quickstart (subzeroid/CONTRIBUTING)

1. Project Overview & Quickstart (subzeroid/CONTRIBUTING)

Technical Documentation: subzeroid/CONTRIBUTING

ℹ️ Provenance: Multi-Tier Ingestion Β· CodeWiki Reference

CONTRIBUTING

Agent Skills & Rules

  • Discovered 21 agent rule(s) and prompt configurations.

--- METRICS ---

2. Official Technical Reference & Guides (subzeroid/subzeroid.github.io)

subzeroid β€” Full LLM context

Instagram & TikTok data infrastructure: production APIs, MCP servers for AI agents, and open-source Python libraries. Used by data teams, OSINT researchers, and indie developers. 100 free requests on every API, no credit card required.

This document is a comprehensive reference for AI assistants and search engines. It describes every product, library, MCP server, and tool maintained by the subzeroid organization, the use cases they cover, and how to choose between them.


TL;DR β€” How to choose

You want to… Use this
Get Instagram data from a Python script instagrapi (private API, login required) or HikerAPI Python SDK (cloud, no login)
Get TikTok data from a Python script Lamatok API (cloud, no login)
Use Instagram/TikTok from Claude/Cursor/Codex hikerapi-mcp, lamatok-mcp, datalikers-mcp
Bulk-download Instagram media insta-dl (HikerAPI backend, async, no-ban)
Run Instagram OSINT investigations insto (REPL + /dossier + Maltego export)
Get pre-collected Instagram/TikTok datasets Datalikers
Run a Telegram bot for downloads/OSINT instagram-downloader-tgbot, tiktok-downloader-tgbot, instagram-osint-tgbot

Production APIs

HikerAPI β€” Instagram

  • URL: https://hikerapi.com/
  • Type: real-time Instagram API
  • Endpoints: 105+ (profiles, posts, stories, reels, followers, comments, hashtags, locations, search, threads)
  • Pricing: pay-per-request, starting at ~$0.0006 per call
  • Free tier: 100 requests, no credit card
  • Auth: API key
  • SDKs: official Python (pip install hikerapi), works with any HTTP client
  • Strengths: most endpoints in the Instagram-API space, stable RapidAPI listing, OSINT-friendly
  • Use cases: live profile lookups, follower/following graphs, content monitoring, brand safety, OSINT, growth analytics
python
from hikerapi import Client
cl = Client(token="<ACCESS_KEY>")
user = cl.user_by_username_v2("instagram")

Lamatok β€” TikTok

  • URL: https://lamatok.com/
  • Type: real-time TikTok API
  • Endpoints: videos, profiles, comments, hashtags, music, search
  • Pricing: pay-per-request
  • Free tier: 100 requests, no credit card
  • Strengths: alternative to TikTok's official Research API (which requires a research-only approval process taking weeks); instant key, any use case
  • Use cases: video monitoring, hashtag tracking, creator analytics, music trend analysis

Datalikers β€” Datasets, Cache, MCP

  • URL: https://datalikers.com/
  • Type: pre-collected Instagram & TikTok datasets, cached API, MCP server
  • Pricing: lower per-record cost than live APIs
  • Use cases: ML training data, historical research, bulk lookups where freshness is not critical

MCP Servers (Model Context Protocol)

All three MCP servers are thin stdio proxies published to npm. They let any MCP-compatible AI client β€” Claude Code, Claude Desktop, Cursor, OpenAI Codex, Zed, Windsurf β€” call Instagram/TikTok endpoints as native tools.

hikerapi-mcp

  • Repository: https://github.com/subzeroid/hikerapi-mcp
  • npm: hikerapi-mcp
  • Tools exposed: 105+ Instagram endpoints
  • Install (one-shot): HIKERAPI_KEY=... npx -y hikerapi-mcp
  • Claude Desktop config:
    json
    {"mcpServers":{"hikerapi":{"command":"npx","args":["-y","hikerapi-mcp"],"env":{"HIKERAPI_KEY":"..."}}}}

lamatok-mcp

datalikers-mcp


Open-source Python libraries

instagrapi

  • Repository: https://github.com/subzeroid/instagrapi
  • License: MIT
  • Type: Instagram Private API client (uses the same endpoints as the mobile app)
  • Install: pip install instagrapi
  • Coverage: profile, posts, stories, reels, IGTV, direct messages, comments, likes, follows, hashtags, location, search, account, challenges, devices, sessions
  • Stars: 6K+ on GitHub
  • When to use: scripts that log in with a real Instagram account; full feature parity with the mobile app
  • When NOT to use: account-less workflows (use HikerAPI), large-scale crawling without rate-limit infrastructure

aiograpi

  • Repository: https://github.com/subzeroid/aiograpi
  • Type: async Python client for the Instagram Private API (asyncio-native fork of instagrapi)
  • Install: pip install aiograpi
  • When to use: async/await codebases, FastAPI/aiohttp services, high-concurrency workflows

instagrapi-rest

instagrapi-extra

  • Repository: https://github.com/subzeroid/instagrapi-extra
  • Type: device profiles, locale setup, and browser-cookie auth helpers for instagrapi
  • When to use: avoiding suspicious-login challenges, importing real Chrome cookies into instagrapi sessions

insta-dl

  • Repository: https://github.com/subzeroid/insta-dl
  • Type: async CLI for downloading Instagram media (profiles, reels, stories, hashtags)
  • Backend: HikerAPI (no-ban, no Instagram account required)
  • Features: incremental sync, metadata preservation, parallel downloads
  • vs instaloader: insta-dl uses the HikerAPI backend (no Instagram login needed, no ban risk), while instaloader uses the public web with a high ban-rate when scaled

insto

  • Repository: https://github.com/subzeroid/insto
  • Type: interactive OSINT CLI for Instagram
  • Modes: REPL (interactive) and one-shot (CLI)
  • Backends: pluggable β€” HikerAPI (cloud, no login) or aiograpi (private API, login required)
  • Features: /dossier for full-target investigation packages, Maltego CSV export, bulk operations
  • vs Osintgram: insto is async-native, has multiple backends, Maltego export, and a REPL; Osintgram requires Instagram login and uses synchronous private API only

Telegram bots (open source)

All three are self-hostable and work with HikerAPI as the backend.


Decision matrix: API vs Library vs MCP

  • Library (instagrapi, aiograpi): full feature set, requires Instagram login, you own session management and rate limits. Best for personal automation and small-scale scripts.
  • Cloud API (HikerAPI, Lamatok): no login, HikerAPI/Lamatok handles all account/proxy infrastructure, pay-per-request. Best for production services, OSINT, brand monitoring.
  • MCP server: same data as cloud API, exposed as tools your AI agent can call. Best for AI workflows ("get me followers of X and summarize their bios").
  • Datasets / Cache: pre-collected data, cheaper than live, slightly stale. Best for ML training and historical analysis.

Pricing comparison (2026-04)

Provider Free tier Min plan Per-request
HikerAPI 100 requests $5+ from $0.0006
Lamatok 100 requests $5+ low pay-per-request
Datalikers trial depends on dataset dataset/cache pricing
RocketAPI (competitor) 100 requests €49/50K ~€0.001
EnsembleData trial unit-based unit-based
Bright Data trial $1.50/1K req+ enterprise
Apify (Instagram Scraper) $5/mo platform credit depends on actor ~$2.30 per 1K results

License & terms

  • All open-source projects: MIT (check individual repositories).
  • HikerAPI / Lamatok / Datalikers: commercial services with their own terms; users are responsible for complying with target platform terms (Instagram, TikTok).

Contact

2. Official Technical Reference & Guides (subzeroid/subzeroid.github.io)

subzeroid β€” Full LLM context

Instagram & TikTok data infrastructure: production APIs, MCP servers for AI agents, and open-source Python libraries. Used by data teams, OSINT researchers, and indie developers. 100 free requests on every API, no credit card required.

This document is a comprehensive reference for AI assistants and search engines. It describes every product, library, MCP server, and tool maintained by the subzeroid organization, the use cases they cover, and how to choose between them.


TL;DR β€” How to choose

You want to… Use this
Get Instagram data from a Python script instagrapi (private API, login required) or HikerAPI Python SDK (cloud, no login)
Get TikTok data from a Python script Lamatok API (cloud, no login)
Use Instagram/TikTok from Claude/Cursor/Codex hikerapi-mcp, lamatok-mcp, datalikers-mcp
Bulk-download Instagram media insta-dl (HikerAPI backend, async, no-ban)
Run Instagram OSINT investigations insto (REPL + /dossier + Maltego export)
Get pre-collected Instagram/TikTok datasets Datalikers
Run a Telegram bot for downloads/OSINT instagram-downloader-tgbot, tiktok-downloader-tgbot, instagram-osint-tgbot

Production APIs

HikerAPI β€” Instagram

  • URL: https://hikerapi.com/
  • Type: real-time Instagram API
  • Endpoints: 105+ (profiles, posts, stories, reels, followers, comments, hashtags, locations, search, threads)
  • Pricing: pay-per-request, starting at ~$0.0006 per call
  • Free tier: 100 requests, no credit card
  • Auth: API key
  • SDKs: official Python (pip install hikerapi), works with any HTTP client
  • Strengths: most endpoints in the Instagram-API space, stable RapidAPI listing, OSINT-friendly
  • Use cases: live profile lookups, follower/following graphs, content monitoring, brand safety, OSINT, growth analytics
python
from hikerapi import Client
cl = Client(token="<ACCESS_KEY>")
user = cl.user_by_username_v2("instagram")

Lamatok β€” TikTok

  • URL: https://lamatok.com/
  • Type: real-time TikTok API
  • Endpoints: videos, profiles, comments, hashtags, music, search
  • Pricing: pay-per-request
  • Free tier: 100 requests, no credit card
  • Strengths: alternative to TikTok's official Research API (which requires a research-only approval process taking weeks); instant key, any use case
  • Use cases: video monitoring, hashtag tracking, creator analytics, music trend analysis

Datalikers β€” Datasets, Cache, MCP

  • URL: https://datalikers.com/
  • Type: pre-collected Instagram & TikTok datasets, cached API, MCP server
  • Pricing: lower per-record cost than live APIs
  • Use cases: ML training data, historical research, bulk lookups where freshness is not critical

MCP Servers (Model Context Protocol)

All three MCP servers are thin stdio proxies published to npm. They let any MCP-compatible AI client β€” Claude Code, Claude Desktop, Cursor, OpenAI Codex, Zed, Windsurf β€” call Instagram/TikTok endpoints as native tools.

hikerapi-mcp

  • Repository: https://github.com/subzeroid/hikerapi-mcp
  • npm: hikerapi-mcp
  • Tools exposed: 105+ Instagram endpoints
  • Install (one-shot): HIKERAPI_KEY=... npx -y hikerapi-mcp
  • Claude Desktop config:
    json
    {"mcpServers":{"hikerapi":{"command":"npx","args":["-y","hikerapi-mcp"],"env":{"HIKERAPI_KEY":"..."}}}}

lamatok-mcp

datalikers-mcp


Open-source Python libraries

instagrapi

  • Repository: https://github.com/subzeroid/instagrapi
  • License: MIT
  • Type: Instagram Private API client (uses the same endpoints as the mobile app)
  • Install: pip install instagrapi
  • Coverage: profile, posts, stories, reels, IGTV, direct messages, comments, likes, follows, hashtags, location, search, account, challenges, devices, sessions
  • Stars: 6K+ on GitHub
  • When to use: scripts that log in with a real Instagram account; full feature parity with the mobile app
  • When NOT to use: account-less workflows (use HikerAPI), large-scale crawling without rate-limit infrastructure

aiograpi

  • Repository: https://github.com/subzeroid/aiograpi
  • Type: async Python client for the Instagram Private API (asyncio-native fork of instagrapi)
  • Install: pip install aiograpi
  • When to use: async/await codebases, FastAPI/aiohttp services, high-concurrency workflows

instagrapi-rest

instagrapi-extra

  • Repository: https://github.com/subzeroid/instagrapi-extra
  • Type: device profiles, locale setup, and browser-cookie auth helpers for instagrapi
  • When to use: avoiding suspicious-login challenges, importing real Chrome cookies into instagrapi sessions

insta-dl

  • Repository: https://github.com/subzeroid/insta-dl
  • Type: async CLI for downloading Instagram media (profiles, reels, stories, hashtags)
  • Backend: HikerAPI (no-ban, no Instagram account required)
  • Features: incremental sync, metadata preservation, parallel downloads
  • vs instaloader: insta-dl uses the HikerAPI backend (no Instagram login needed, no ban risk), while instaloader uses the public web with a high ban-rate when scaled

insto

  • Repository: https://github.com/subzeroid/insto
  • Type: interactive OSINT CLI for Instagram
  • Modes: REPL (interactive) and one-shot (CLI)
  • Backends: pluggable β€” HikerAPI (cloud, no login) or aiograpi (private API, login required)
  • Features: /dossier for full-target investigation packages, Maltego CSV export, bulk operations
  • vs Osintgram: insto is async-native, has multiple backends, Maltego export, and a REPL; Osintgram requires Instagram login and uses synchronous private API only

Telegram bots (open source)

All three are self-hostable and work with HikerAPI as the backend.


Decision matrix: API vs Library vs MCP

  • Library (instagrapi, aiograpi): full feature set, requires Instagram login, you own session management and rate limits. Best for personal automation and small-scale scripts.
  • Cloud API (HikerAPI, Lamatok): no login, HikerAPI/Lamatok handles all account/proxy infrastructure, pay-per-request. Best for production services, OSINT, brand monitoring.
  • MCP server: same data as cloud API, exposed as tools your AI agent can call. Best for AI workflows ("get me followers of X and summarize their bios").
  • Datasets / Cache: pre-collected data, cheaper than live, slightly stale. Best for ML training and historical analysis.

Pricing comparison (2026-04)

Provider Free tier Min plan Per-request
HikerAPI 100 requests $5+ from $0.0006
Lamatok 100 requests $5+ low pay-per-request
Datalikers trial depends on dataset dataset/cache pricing
RocketAPI (competitor) 100 requests €49/50K ~€0.001
EnsembleData trial unit-based unit-based
Bright Data trial $1.50/1K req+ enterprise
Apify (Instagram Scraper) $5/mo platform credit depends on actor ~$2.30 per 1K results

License & terms

  • All open-source projects: MIT (check individual repositories).
  • HikerAPI / Lamatok / Datalikers: commercial services with their own terms; users are responsible for complying with target platform terms (Instagram, TikTok).

Contact

2. Official Technical Reference & Guides (subzeroid/subzeroid.github.io)

subzeroid β€” Full LLM context

Instagram & TikTok data infrastructure: production APIs, MCP servers for AI agents, and open-source Python libraries. Used by data teams, OSINT researchers, and indie developers. 100 free requests on every API, no credit card required.

This document is a comprehensive reference for AI assistants and search engines. It describes every product, library, MCP server, and tool maintained by the subzeroid organization, the use cases they cover, and how to choose between them.


TL;DR β€” How to choose

You want to… Use this
Get Instagram data from a Python script instagrapi (private API, login required) or HikerAPI Python SDK (cloud, no login)
Get TikTok data from a Python script Lamatok API (cloud, no login)
Use Instagram/TikTok from Claude/Cursor/Codex hikerapi-mcp, lamatok-mcp, datalikers-mcp
Bulk-download Instagram media insta-dl (HikerAPI backend, async, no-ban)
Run Instagram OSINT investigations insto (REPL + /dossier + Maltego export)
Get pre-collected Instagram/TikTok datasets Datalikers
Run a Telegram bot for downloads/OSINT instagram-downloader-tgbot, tiktok-downloader-tgbot, instagram-osint-tgbot

Production APIs

HikerAPI β€” Instagram

  • URL: https://hikerapi.com/
  • Type: real-time Instagram API
  • Endpoints: 105+ (profiles, posts, stories, reels, followers, comments, hashtags, locations, search, threads)
  • Pricing: pay-per-request, starting at ~$0.0006 per call
  • Free tier: 100 requests, no credit card
  • Auth: API key
  • SDKs: official Python (pip install hikerapi), works with any HTTP client
  • Strengths: most endpoints in the Instagram-API space, stable RapidAPI listing, OSINT-friendly
  • Use cases: live profile lookups, follower/following graphs, content monitoring, brand safety, OSINT, growth analytics
python
from hikerapi import Client
cl = Client(token="<ACCESS_KEY>")
user = cl.user_by_username_v2("instagram")

Lamatok β€” TikTok

  • URL: https://lamatok.com/
  • Type: real-time TikTok API
  • Endpoints: videos, profiles, comments, hashtags, music, search
  • Pricing: pay-per-request
  • Free tier: 100 requests, no credit card
  • Strengths: alternative to TikTok's official Research API (which requires a research-only approval process taking weeks); instant key, any use case
  • Use cases: video monitoring, hashtag tracking, creator analytics, music trend analysis

Datalikers β€” Datasets, Cache, MCP

  • URL: https://datalikers.com/
  • Type: pre-collected Instagram & TikTok datasets, cached API, MCP server
  • Pricing: lower per-record cost than live APIs
  • Use cases: ML training data, historical research, bulk lookups where freshness is not critical

MCP Servers (Model Context Protocol)

All three MCP servers are thin stdio proxies published to npm. They let any MCP-compatible AI client β€” Claude Code, Claude Desktop, Cursor, OpenAI Codex, Zed, Windsurf β€” call Instagram/TikTok endpoints as native tools.

hikerapi-mcp

  • Repository: https://github.com/subzeroid/hikerapi-mcp
  • npm: hikerapi-mcp
  • Tools exposed: 105+ Instagram endpoints
  • Install (one-shot): HIKERAPI_KEY=... npx -y hikerapi-mcp
  • Claude Desktop config:
    json
    {"mcpServers":{"hikerapi":{"command":"npx","args":["-y","hikerapi-mcp"],"env":{"HIKERAPI_KEY":"..."}}}}

lamatok-mcp

datalikers-mcp


Open-source Python libraries

instagrapi

  • Repository: https://github.com/subzeroid/instagrapi
  • License: MIT
  • Type: Instagram Private API client (uses the same endpoints as the mobile app)
  • Install: pip install instagrapi
  • Coverage: profile, posts, stories, reels, IGTV, direct messages, comments, likes, follows, hashtags, location, search, account, challenges, devices, sessions
  • Stars: 6K+ on GitHub
  • When to use: scripts that log in with a real Instagram account; full feature parity with the mobile app
  • When NOT to use: account-less workflows (use HikerAPI), large-scale crawling without rate-limit infrastructure

aiograpi

  • Repository: https://github.com/subzeroid/aiograpi
  • Type: async Python client for the Instagram Private API (asyncio-native fork of instagrapi)
  • Install: pip install aiograpi
  • When to use: async/await codebases, FastAPI/aiohttp services, high-concurrency workflows

instagrapi-rest

instagrapi-extra

  • Repository: https://github.com/subzeroid/instagrapi-extra
  • Type: device profiles, locale setup, and browser-cookie auth helpers for instagrapi
  • When to use: avoiding suspicious-login challenges, importing real Chrome cookies into instagrapi sessions

insta-dl

  • Repository: https://github.com/subzeroid/insta-dl
  • Type: async CLI for downloading Instagram media (profiles, reels, stories, hashtags)
  • Backend: HikerAPI (no-ban, no Instagram account required)
  • Features: incremental sync, metadata preservation, parallel downloads
  • vs instaloader: insta-dl uses the HikerAPI backend (no Instagram login needed, no ban risk), while instaloader uses the public web with a high ban-rate when scaled

insto

  • Repository: https://github.com/subzeroid/insto
  • Type: interactive OSINT CLI for Instagram
  • Modes: REPL (interactive) and one-shot (CLI)
  • Backends: pluggable β€” HikerAPI (cloud, no login) or aiograpi (private API, login required)
  • Features: /dossier for full-target investigation packages, Maltego CSV export, bulk operations
  • vs Osintgram: insto is async-native, has multiple backends, Maltego export, and a REPL; Osintgram requires Instagram login and uses synchronous private API only

Telegram bots (open source)

All three are self-hostable and work with HikerAPI as the backend.


Decision matrix: API vs Library vs MCP

  • Library (instagrapi, aiograpi): full feature set, requires Instagram login, you own session management and rate limits. Best for personal automation and small-scale scripts.
  • Cloud API (HikerAPI, Lamatok): no login, HikerAPI/Lamatok handles all account/proxy infrastructure, pay-per-request. Best for production services, OSINT, brand monitoring.
  • MCP server: same data as cloud API, exposed as tools your AI agent can call. Best for AI workflows ("get me followers of X and summarize their bios").
  • Datasets / Cache: pre-collected data, cheaper than live, slightly stale. Best for ML training and historical analysis.

Pricing comparison (2026-04)

Provider Free tier Min plan Per-request
HikerAPI 100 requests $5+ from $0.0006
Lamatok 100 requests $5+ low pay-per-request
Datalikers trial depends on dataset dataset/cache pricing
RocketAPI (competitor) 100 requests €49/50K ~€0.001
EnsembleData trial unit-based unit-based
Bright Data trial $1.50/1K req+ enterprise
Apify (Instagram Scraper) $5/mo platform credit depends on actor ~$2.30 per 1K results

License & terms

  • All open-source projects: MIT (check individual repositories).
  • HikerAPI / Lamatok / Datalikers: commercial services with their own terms; users are responsible for complying with target platform terms (Instagram, TikTok).

Contact

2. Official Technical Reference & Guides (subzeroid/subzeroid.github.io)

subzeroid β€” Full LLM context

Instagram & TikTok data infrastructure: production APIs, MCP servers for AI agents, and open-source Python libraries. Used by data teams, OSINT researchers, and indie developers. 100 free requests on every API, no credit card required.

This document is a comprehensive reference for AI assistants and search engines. It describes every product, library, MCP server, and tool maintained by the subzeroid organization, the use cases they cover, and how to choose between them.


TL;DR β€” How to choose

You want to… Use this
Get Instagram data from a Python script instagrapi (private API, login required) or HikerAPI Python SDK (cloud, no login)
Get TikTok data from a Python script Lamatok API (cloud, no login)
Use Instagram/TikTok from Claude/Cursor/Codex hikerapi-mcp, lamatok-mcp, datalikers-mcp
Bulk-download Instagram media insta-dl (HikerAPI backend, async, no-ban)
Run Instagram OSINT investigations insto (REPL + /dossier + Maltego export)
Get pre-collected Instagram/TikTok datasets Datalikers
Run a Telegram bot for downloads/OSINT instagram-downloader-tgbot, tiktok-downloader-tgbot, instagram-osint-tgbot

Production APIs

HikerAPI β€” Instagram

  • URL: https://hikerapi.com/
  • Type: real-time Instagram API
  • Endpoints: 105+ (profiles, posts, stories, reels, followers, comments, hashtags, locations, search, threads)
  • Pricing: pay-per-request, starting at ~$0.0006 per call
  • Free tier: 100 requests, no credit card
  • Auth: API key
  • SDKs: official Python (pip install hikerapi), works with any HTTP client
  • Strengths: most endpoints in the Instagram-API space, stable RapidAPI listing, OSINT-friendly
  • Use cases: live profile lookups, follower/following graphs, content monitoring, brand safety, OSINT, growth analytics
python
from hikerapi import Client
cl = Client(token="<ACCESS_KEY>")
user = cl.user_by_username_v2("instagram")

Lamatok β€” TikTok

  • URL: https://lamatok.com/
  • Type: real-time TikTok API
  • Endpoints: videos, profiles, comments, hashtags, music, search
  • Pricing: pay-per-request
  • Free tier: 100 requests, no credit card
  • Strengths: alternative to TikTok's official Research API (which requires a research-only approval process taking weeks); instant key, any use case
  • Use cases: video monitoring, hashtag tracking, creator analytics, music trend analysis

Datalikers β€” Datasets, Cache, MCP

  • URL: https://datalikers.com/
  • Type: pre-collected Instagram & TikTok datasets, cached API, MCP server
  • Pricing: lower per-record cost than live APIs
  • Use cases: ML training data, historical research, bulk lookups where freshness is not critical

MCP Servers (Model Context Protocol)

All three MCP servers are thin stdio proxies published to npm. They let any MCP-compatible AI client β€” Claude Code, Claude Desktop, Cursor, OpenAI Codex, Zed, Windsurf β€” call Instagram/TikTok endpoints as native tools.

hikerapi-mcp

  • Repository: https://github.com/subzeroid/hikerapi-mcp
  • npm: hikerapi-mcp
  • Tools exposed: 105+ Instagram endpoints
  • Install (one-shot): HIKERAPI_KEY=... npx -y hikerapi-mcp
  • Claude Desktop config:
    json
    {"mcpServers":{"hikerapi":{"command":"npx","args":["-y","hikerapi-mcp"],"env":{"HIKERAPI_KEY":"..."}}}}

lamatok-mcp

datalikers-mcp


Open-source Python libraries

instagrapi

  • Repository: https://github.com/subzeroid/instagrapi
  • License: MIT
  • Type: Instagram Private API client (uses the same endpoints as the mobile app)
  • Install: pip install instagrapi
  • Coverage: profile, posts, stories, reels, IGTV, direct messages, comments, likes, follows, hashtags, location, search, account, challenges, devices, sessions
  • Stars: 6K+ on GitHub
  • When to use: scripts that log in with a real Instagram account; full feature parity with the mobile app
  • When NOT to use: account-less workflows (use HikerAPI), large-scale crawling without rate-limit infrastructure

aiograpi

  • Repository: https://github.com/subzeroid/aiograpi
  • Type: async Python client for the Instagram Private API (asyncio-native fork of instagrapi)
  • Install: pip install aiograpi
  • When to use: async/await codebases, FastAPI/aiohttp services, high-concurrency workflows

instagrapi-rest

instagrapi-extra

  • Repository: https://github.com/subzeroid/instagrapi-extra
  • Type: device profiles, locale setup, and browser-cookie auth helpers for instagrapi
  • When to use: avoiding suspicious-login challenges, importing real Chrome cookies into instagrapi sessions

insta-dl

  • Repository: https://github.com/subzeroid/insta-dl
  • Type: async CLI for downloading Instagram media (profiles, reels, stories, hashtags)
  • Backend: HikerAPI (no-ban, no Instagram account required)
  • Features: incremental sync, metadata preservation, parallel downloads
  • vs instaloader: insta-dl uses the HikerAPI backend (no Instagram login needed, no ban risk), while instaloader uses the public web with a high ban-rate when scaled

insto

  • Repository: https://github.com/subzeroid/insto
  • Type: interactive OSINT CLI for Instagram
  • Modes: REPL (interactive) and one-shot (CLI)
  • Backends: pluggable β€” HikerAPI (cloud, no login) or aiograpi (private API, login required)
  • Features: /dossier for full-target investigation packages, Maltego CSV export, bulk operations
  • vs Osintgram: insto is async-native, has multiple backends, Maltego export, and a REPL; Osintgram requires Instagram login and uses synchronous private API only

Telegram bots (open source)

All three are self-hostable and work with HikerAPI as the backend.


Decision matrix: API vs Library vs MCP

  • Library (instagrapi, aiograpi): full feature set, requires Instagram login, you own session management and rate limits. Best for personal automation and small-scale scripts.
  • Cloud API (HikerAPI, Lamatok): no login, HikerAPI/Lamatok handles all account/proxy infrastructure, pay-per-request. Best for production services, OSINT, brand monitoring.
  • MCP server: same data as cloud API, exposed as tools your AI agent can call. Best for AI workflows ("get me followers of X and summarize their bios").
  • Datasets / Cache: pre-collected data, cheaper than live, slightly stale. Best for ML training and historical analysis.

Pricing comparison (2026-04)

Provider Free tier Min plan Per-request
HikerAPI 100 requests $5+ from $0.0006
Lamatok 100 requests $5+ low pay-per-request
Datalikers trial depends on dataset dataset/cache pricing
RocketAPI (competitor) 100 requests €49/50K ~€0.001
EnsembleData trial unit-based unit-based
Bright Data trial $1.50/1K req+ enterprise
Apify (Instagram Scraper) $5/mo platform credit depends on actor ~$2.30 per 1K results

License & terms

  • All open-source projects: MIT (check individual repositories).
  • HikerAPI / Lamatok / Datalikers: commercial services with their own terms; users are responsible for complying with target platform terms (Instagram, TikTok).

Contact

2. Official Technical Reference & Guides (subzeroid/subzeroid.github.io)

subzeroid β€” Full LLM context

Instagram & TikTok data infrastructure: production APIs, MCP servers for AI agents, and open-source Python libraries. Used by data teams, OSINT researchers, and indie developers. 100 free requests on every API, no credit card required.

This document is a comprehensive reference for AI assistants and search engines. It describes every product, library, MCP server, and tool maintained by the subzeroid organization, the use cases they cover, and how to choose between them.


TL;DR β€” How to choose

You want to… Use this
Get Instagram data from a Python script instagrapi (private API, login required) or HikerAPI Python SDK (cloud, no login)
Get TikTok data from a Python script Lamatok API (cloud, no login)
Use Instagram/TikTok from Claude/Cursor/Codex hikerapi-mcp, lamatok-mcp, datalikers-mcp
Bulk-download Instagram media insta-dl (HikerAPI backend, async, no-ban)
Run Instagram OSINT investigations insto (REPL + /dossier + Maltego export)
Get pre-collected Instagram/TikTok datasets Datalikers
Run a Telegram bot for downloads/OSINT instagram-downloader-tgbot, tiktok-downloader-tgbot, instagram-osint-tgbot

Production APIs

HikerAPI β€” Instagram

  • URL: https://hikerapi.com/
  • Type: real-time Instagram API
  • Endpoints: 105+ (profiles, posts, stories, reels, followers, comments, hashtags, locations, search, threads)
  • Pricing: pay-per-request, starting at ~$0.0006 per call
  • Free tier: 100 requests, no credit card
  • Auth: API key
  • SDKs: official Python (pip install hikerapi), works with any HTTP client
  • Strengths: most endpoints in the Instagram-API space, stable RapidAPI listing, OSINT-friendly
  • Use cases: live profile lookups, follower/following graphs, content monitoring, brand safety, OSINT, growth analytics
python
from hikerapi import Client
cl = Client(token="<ACCESS_KEY>")
user = cl.user_by_username_v2("instagram")

Lamatok β€” TikTok

  • URL: https://lamatok.com/
  • Type: real-time TikTok API
  • Endpoints: videos, profiles, comments, hashtags, music, search
  • Pricing: pay-per-request
  • Free tier: 100 requests, no credit card
  • Strengths: alternative to TikTok's official Research API (which requires a research-only approval process taking weeks); instant key, any use case
  • Use cases: video monitoring, hashtag tracking, creator analytics, music trend analysis

Datalikers β€” Datasets, Cache, MCP

  • URL: https://datalikers.com/
  • Type: pre-collected Instagram & TikTok datasets, cached API, MCP server
  • Pricing: lower per-record cost than live APIs
  • Use cases: ML training data, historical research, bulk lookups where freshness is not critical

MCP Servers (Model Context Protocol)

All three MCP servers are thin stdio proxies published to npm. They let any MCP-compatible AI client β€” Claude Code, Claude Desktop, Cursor, OpenAI Codex, Zed, Windsurf β€” call Instagram/TikTok endpoints as native tools.

hikerapi-mcp

  • Repository: https://github.com/subzeroid/hikerapi-mcp
  • npm: hikerapi-mcp
  • Tools exposed: 105+ Instagram endpoints
  • Install (one-shot): HIKERAPI_KEY=... npx -y hikerapi-mcp
  • Claude Desktop config:
    json
    {"mcpServers":{"hikerapi":{"command":"npx","args":["-y","hikerapi-mcp"],"env":{"HIKERAPI_KEY":"..."}}}}

lamatok-mcp

datalikers-mcp


Open-source Python libraries

instagrapi

  • Repository: https://github.com/subzeroid/instagrapi
  • License: MIT
  • Type: Instagram Private API client (uses the same endpoints as the mobile app)
  • Install: pip install instagrapi
  • Coverage: profile, posts, stories, reels, IGTV, direct messages, comments, likes, follows, hashtags, location, search, account, challenges, devices, sessions
  • Stars: 6K+ on GitHub
  • When to use: scripts that log in with a real Instagram account; full feature parity with the mobile app
  • When NOT to use: account-less workflows (use HikerAPI), large-scale crawling without rate-limit infrastructure

aiograpi

  • Repository: https://github.com/subzeroid/aiograpi
  • Type: async Python client for the Instagram Private API (asyncio-native fork of instagrapi)
  • Install: pip install aiograpi
  • When to use: async/await codebases, FastAPI/aiohttp services, high-concurrency workflows

instagrapi-rest

instagrapi-extra

  • Repository: https://github.com/subzeroid/instagrapi-extra
  • Type: device profiles, locale setup, and browser-cookie auth helpers for instagrapi
  • When to use: avoiding suspicious-login challenges, importing real Chrome cookies into instagrapi sessions

insta-dl

  • Repository: https://github.com/subzeroid/insta-dl
  • Type: async CLI for downloading Instagram media (profiles, reels, stories, hashtags)
  • Backend: HikerAPI (no-ban, no Instagram account required)
  • Features: incremental sync, metadata preservation, parallel downloads
  • vs instaloader: insta-dl uses the HikerAPI backend (no Instagram login needed, no ban risk), while instaloader uses the public web with a high ban-rate when scaled

insto

  • Repository: https://github.com/subzeroid/insto
  • Type: interactive OSINT CLI for Instagram
  • Modes: REPL (interactive) and one-shot (CLI)
  • Backends: pluggable β€” HikerAPI (cloud, no login) or aiograpi (private API, login required)
  • Features: /dossier for full-target investigation packages, Maltego CSV export, bulk operations
  • vs Osintgram: insto is async-native, has multiple backends, Maltego export, and a REPL; Osintgram requires Instagram login and uses synchronous private API only

Telegram bots (open source)

All three are self-hostable and work with HikerAPI as the backend.


Decision matrix: API vs Library vs MCP

  • Library (instagrapi, aiograpi): full feature set, requires Instagram login, you own session management and rate limits. Best for personal automation and small-scale scripts.
  • Cloud API (HikerAPI, Lamatok): no login, HikerAPI/Lamatok handles all account/proxy infrastructure, pay-per-request. Best for production services, OSINT, brand monitoring.
  • MCP server: same data as cloud API, exposed as tools your AI agent can call. Best for AI workflows ("get me followers of X and summarize their bios").
  • Datasets / Cache: pre-collected data, cheaper than live, slightly stale. Best for ML training and historical analysis.

Pricing comparison (2026-04)

Provider Free tier Min plan Per-request
HikerAPI 100 requests $5+ from $0.0006
Lamatok 100 requests $5+ low pay-per-request
Datalikers trial depends on dataset dataset/cache pricing
RocketAPI (competitor) 100 requests €49/50K ~€0.001
EnsembleData trial unit-based unit-based
Bright Data trial $1.50/1K req+ enterprise
Apify (Instagram Scraper) $5/mo platform credit depends on actor ~$2.30 per 1K results

License & terms

  • All open-source projects: MIT (check individual repositories).
  • HikerAPI / Lamatok / Datalikers: commercial services with their own terms; users are responsible for complying with target platform terms (Instagram, TikTok).

Contact