# HikerAPI

> Unofficial Instagram REST API. Access user profiles, posts, stories, reels, comments, followers, hashtags, and locations. 101 endpoints, no blocks. From $0.0006 per request.

## Docs

- [API Reference](https://api.hikerapi.com/docs): Interactive Swagger UI with all 101 endpoints
- [ReDoc](https://api.hikerapi.com/redoc): Alternative API documentation
- [Documentation](https://hiker-doc.readthedocs.io/): Getting started guides and examples
- [Python Package](https://pypi.org/project/hikerapi/): Official Python SDK on PyPI
- [JavaScript Package](https://www.npmjs.com/package/hikerapi): Official JavaScript SDK on npm
- [MCP Server](https://www.npmjs.com/package/hikerapi-mcp): Use HikerAPI from Claude, Cursor, and other AI assistants — `npx -y hikerapi-mcp`

## Features

- Get public data of user profiles, posts, stories, highlights, followers and following users
- Get public email and phone number from business profiles
- Get public data of post, story, album, reels with the ability to download content
- Get public data of hashtag and location, as well as a list of posts for them
- Get all comments on a post and a list of users who liked it
- Download and upload a photo, video, reels, albums and stories

## API Categories

### /v1/user (25 endpoints)
User profiles, followers, following, media. Includes:
- Get user profile by username or ID
- Get user followers and following lists (chunked, up to 100 per request)
- Get user media feed, reels, tagged posts
- Get user stories and highlights
- Get business contact info (email, phone)

### /v1/media (16 endpoints)
Posts, reels, comments, likers. Includes:
- Get media info by shortcode or ID
- Get media comments and likers
- Get media download URLs
- Upload photos, videos, reels, albums

### /gql (20 endpoints)
GraphQL-based data access. Includes:
- /gql/user/followers/chunk - 50 records per request, works with verified users
- /gql/user/following/chunk - 50 records per request
- Alternative interface for profile and media data

### /v1/hashtag (8 endpoints)
Hashtag search and posts. Includes:
- Search hashtags
- Get top and recent posts by hashtag
- Get hashtag metadata and post counts

### /v1/location (7 endpoints)
Location search and posts. Includes:
- Search locations by name
- Get top and recent posts by location
- Get location metadata

### /v1/story (5 endpoints)
Stories and highlights. Includes:
- Get user stories
- Get user highlights
- Get story/highlight details and media

### /v1/search (3 endpoints)
User and content search. Includes:
- Search users by username or name
- Search places and hashtags
- Facebook search integration

## Pricing

Pay-as-you-go from $0.0006 per request. 100 free requests on signup.

- We charge for any successful response (200, 403, 404)
- For 50x server errors we do not charge
- Funds never expire - if you stop making requests, your balance remains unchanged
- Volume discounts available - contact support for 1M+ request plans

## FAQ

### Do you have a plan to make over a million requests?
Yes, you can write to us by email (support@hikerapi.com) or Telegram (https://t.me/hikerapi).

### Will my funds expire at the end of the month?
No, we only charge for successful requests. If you stop making requests your balance will remain unchanged.

### What requests do you charge for?
We charge for any successful response (such as 200, 403, 404). For 50x errors we do not charge.

### Do you have a referral program?
Yes, we have a referral program. See https://hikerapi.com/help/affiliate for details.

### What are the differences between API versions?
- **Version v1:** Validated data ensuring compliance with standards. You receive necessary and verified fields, simplifying integration and reducing errors.
- **Version v2:** Raw data as originally provided. In rare cases, some fields may be modified or added.
- **Version gql:** GraphQL API - select and query specific data, retrieve only relevant information without unnecessary data.

### What is the best endpoint to use to get followers/followings?
- v1: /v1/user/following/chunk and /v1/user/followers/chunk - 25 to 100 records per request
- v2: /v2/user/following and /v2/user/followers - 25 to 100 records per request
- gql: /gql/user/followers/chunk and /gql/user/following/chunk - 50 records per request, allows collecting data on verified users

## Solutions

### Instagram API
Complete Instagram REST API with 100+ endpoints for accessing user profiles, posts, stories, reels, comments, followers, hashtags, and locations. No blocks. From $0.0006 per request.
- Page: https://hikerapi.com/instagram-api

### Instagram Private API
Unofficial Mobile API — no authentication required, no session management, automatic recovery from blocks. Access private-level Instagram data without Graph API limitations.
- Page: https://hikerapi.com/instagram-private-api

### Instagram Followers API
Get full follower and following lists via /v1/user/followers/chunk and /gql/user/followers/chunk. Paginated responses, up to 100 records per request. Bulk export support.
- Page: https://hikerapi.com/instagram-followers-api

### Instagram Scraper API
Managed Instagram scraping at scale — no proxies, no blocks, no infrastructure management. Get structured JSON data instead of raw HTML.
- Page: https://hikerapi.com/instagram-scraper-api

### Instagram Reels API
Download and analyze Instagram Reels. Get video URLs, view counts, like counts, comments, and metadata. Fetch user reels feed with pagination.
- Page: https://hikerapi.com/instagram-reels-api

### Threads API
Access public Threads data with a structured API. Retrieve user profiles, threads, replies, followers, following, and engagement signals without maintaining your own scraping stack.
- Page: https://hikerapi.com/threads-api

### RocketAPI Alternative
Alternative to RocketAPI for teams that need stronger pricing transparency, broader Instagram endpoint coverage, top-level SEO pages, and a richer public documentation footprint.
- Page: https://hikerapi.com/rocketapi-alternative

### HikerAPI vs RocketAPI
Direct product comparison covering API coverage, pricing model, documentation depth, integration effort, and best-fit use cases for SaaS, analytics, and monitoring products.
- Page: https://hikerapi.com/hikerapi-vs-rocketapi

### instagrapi Alternative
Managed REST API that wraps the same Instagram private endpoints as the instagrapi open-source Python library, without account bans, proxies, or captchas on the caller's side. Targets teams moving from instagrapi to a supported production stack.
- Page: https://hikerapi.com/instagrapi-alternative

## Language Guides

### Instagram API for Python
Official hikerapi PyPI package. Installation: `pip install hikerapi`. Supports async/await, type hints, pagination helpers.
- Page: https://hikerapi.com/instagram-api-python

### Instagram API for Node.js
Use with fetch or axios. Installation: `npm install axios`. Supports async/await, TypeScript, ES modules.
- Page: https://hikerapi.com/instagram-api-nodejs

### Instagram API for PHP
Use with cURL or file_get_contents. Composer integration, Laravel/Symfony compatible.
- Page: https://hikerapi.com/instagram-api-php

### Instagram API for Go
Use with net/http. Struct-based response parsing, concurrent request patterns with goroutines.
- Page: https://hikerapi.com/instagram-api-go

### Instagram API for Java
Use with java.net.http.HttpClient. Maven dependency, Spring Boot integration, Jackson JSON parsing.
- Page: https://hikerapi.com/instagram-api-java

## AI Assistants / MCP

### HikerAPI MCP Server
HikerAPI is available as a Model Context Protocol (MCP) server, so any MCP-compatible AI assistant — Claude Code, Claude Desktop, Cursor, OpenAI Codex, Zed, Windsurf — can call HikerAPI endpoints directly.

The server is published on npm as `hikerapi-mcp`. It runs locally as a stdio process (Node.js >= 20). On startup it fetches the live HikerAPI OpenAPI spec from `https://api.hikerapi.com/openapi.json` and auto-generates one MCP tool per non-deprecated GET endpoint — about 105 tools across User Profile (36), Post Details (20), Search (13), Hashtags (7), Stories (7), Locations (7), Audio, Highlights, Share, Comments. As HikerAPI grows, new endpoints become tools automatically without releasing a new version of `hikerapi-mcp`.

- npm: https://www.npmjs.com/package/hikerapi-mcp
- GitHub: https://github.com/subzeroid/hikerapi-mcp
- License: MIT

#### Install for Claude Code
```bash
claude mcp add hikerapi -e HIKERAPI_KEY=your-api-key -- npx -y hikerapi-mcp
```

#### Install for Claude Desktop / Cursor / Windsurf
```json
{
  "mcpServers": {
    "hikerapi": {
      "command": "npx",
      "args": ["-y", "hikerapi-mcp"],
      "env": { "HIKERAPI_KEY": "your-api-key" }
    }
  }
}
```

#### Install for OpenAI Codex (append to `~/.codex/config.toml`)
```toml
[mcp_servers.hikerapi]
command = "npx"
args = ["-y", "hikerapi-mcp"]

[mcp_servers.hikerapi.env]
HIKERAPI_KEY = "your-api-key"
```

#### Install for Zed (`~/.config/zed/settings.json`)
```json
{
  "context_servers": {
    "hikerapi": {
      "command": "npx",
      "args": ["-y", "hikerapi-mcp"],
      "env": { "HIKERAPI_KEY": "your-api-key" }
    }
  }
}
```

#### Configuration
- `HIKERAPI_KEY` (required) — your HikerAPI access key, sent as `x-access-key` header
- `HIKERAPI_TAGS` (optional) — comma-separated whitelist of tags (e.g. `User Profile,Post Details,Search`) to limit which tools are exposed
- `HIKERAPI_EXCLUDE_TAGS` (optional) — additional tags to exclude (defaults already exclude `Legacy` and `System`)
- `HIKERAPI_TIMEOUT_MS` (optional) — per-request timeout, default 30000

#### Pricing
The MCP server is free (MIT). HikerAPI usage is charged the same as direct API calls — pay-as-you-go from $0.0006 per request, 100 free requests on signup. No subscription required.

## Support

- Email: support@hikerapi.com
- Telegram: https://t.me/hikerapi
- Status page: https://hikerapi.com/status

## Legal

- [Terms of Service](https://hikerapi.com/help/terms-of-service)
- [Privacy Policy](https://hikerapi.com/help/privacy-policy)
- [Refund Policy](https://hikerapi.com/help/refund-policy)