instagram-search

# Instagram Search

**Search 400M+ Instagram posts and reels — captions AND video subtitles.**

Find influencers, track hashtags, discover content trends, and export results. No Meta developer account, no Instagram Graph API setup, no app review process.

---

## ⚡ Setup

👉 **Follow [`xpoz-setup`](https://clawhub.ai/skills/xpoz-setup)** — handles auth automatically.

---

## Setup

Run `xpoz-setup` skill. Verify: `mcporter call xpoz.checkAccessKeyStatus`

## What You Can Search

| Tool | What It Does |
|------|-------------|
| `getInstagramPostsByKeywords` | Search posts & reels by keywords |
| `getInstagramUsersByKeywords` | Find users posting about a topic |
| `getInstagramUser` | Look up a specific profile |
| `searchInstagramUsers` | Find accounts by display name |
| `getInstagramPostsByAuthor` | Get a user's post history |

---

## Quick Examples

### Search Posts & Reels

```bash
mcporter call xpoz.getInstagramPostsByKeywords \
  query="sustainable fashion" \
  startDate=2026-01-01 \
  limit=100

# Poll for results:
mcporter call xpoz.checkOperationStatus operationId=op_abc123
```

Xpoz indexes both **captions** and **video subtitles** — so you can find reels by what people *say*, not just what they type.

### Find Influencers by Topic

```bash
mcporter call xpoz.getInstagramUsersByKeywords \
  query="fitness transformation OR workout routine" \
  limit=200
```

### Look Up a Profile

```bash
mcporter call xpoz.getInstagramUser \
  identifier=natgeo \
  identifierType=username
```

### Search by Display Name

```bash
mcporter call xpoz.searchInstagramUsers query="National Geographic" limit=20
```

---

## Boolean Queries

```bash
mcporter call xpoz.getInstagramPostsByKeywords \
  query="(vegan OR plant-based) AND recipe NOT sponsored"
```

---

## CSV Export

Every search generates a full export. Poll the `dataDumpExportOperationId` for a CSV download URL (up to 64K rows).

---

## Why Not Use the Instagram API Directly?

| | Instagram Graph API | Xpoz Insta...