FeedMCP

Data APIs / Instagram

Instagram account search API

Find Instagram accounts by keyword: username, name, avatar, verification and whether private, about 50 in one go, no further pages.

Item Value
Endpoint GET https://api.feedmcp.com/v1/instagram/users/search
ID instagram.users.search
Price $0.003 / call
Returns A page of Account objects
Auth Authorization: Bearer $FEEDMCP_API_KEY

About 50 in one go, no further pages, and no follower counts; use the profile endpoint for those.

Parameters

Name Type Required Description
keyword string yes Search keyword

Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.

Returned fields

data.items is a list of Account objects, with the same fields on every platform:

Field Type Description
id string Account ID, the same id the platform's account endpoints take: the username on TikTok, Instagram, X and Threads, the channel name on Telegram, the subreddit name on Reddit, the part after /in/ or /company/ on LinkedIn, the page name or number on Facebook, the UC… channel ID on YouTube, sec_user_id on Douyin, the numeric user ID on Kuaishou, v2_…@finder on WeChat Channels, the profile token on Zhihu, the user ID on Xiaohongshu, the UID on Bilibili and Weibo, the gh_… ID on WeChat
platform string Platform
name string | null Display name
handle string | null Handle: username, Douyin ID, RED ID or WeChat ID
uid string | null Numeric Douyin uid (Douyin only; the Ocean Engine creator endpoints take it)
bio string | null Bio
avatar string | null Avatar URL
url string | null Profile link
verified boolean | null Verified
verified_reason string | null Verification label or owner
metrics.followers number | null Followers
metrics.following number | null Following
metrics.posts number | null Posts
metrics.likes number | null Likes received
metrics.views number | null Total views (YouTube channels only)
metrics.employees number | null Employees (LinkedIn companies only)
metrics.weekly_active_users number | null Weekly active users (subreddits only)
metrics.articles number | null Articles (Zhihu account search only)
private boolean | null Private account (Instagram account search only)
owner object | null The registered owner: name, country, registered_at, verified_at and third_party_services (account owner endpoint only)
metrics.ads number | null Roughly how many ads (Google advertisers only)
metrics.instagram_followers number | null Followers of the linked Instagram (Meta advertisers only)
location string | null Location (LinkedIn and Facebook)
category string | null Category: Facebook page category, LinkedIn industry, or WeChat account type (Official Account, service account, Channels or mini program)
website string | null Website (LinkedIn companies and Facebook pages)
experience object[] LinkedIn: organizations shown publicly, with organization, location, start and end
education object[] LinkedIn: schools and organizations shown publicly, with school, start and end

When you are charged

$0.003 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Each answer carries meta.billing: what this call cost and the balance left.

Request

cURL

curl "https://api.feedmcp.com/v1/instagram/users/search?keyword=camping" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/instagram/users/search",
    params={"keyword": "camping"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/instagram/users/search?keyword=camping", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "instagram.users.search",
  "params": {
    "keyword": "camping"
  },
  "max_price": "0.003"
}

Response

The data below is made up; the shape is the real one.

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "name": "Kayla",
        "handle": "camping.kayla1",
        "bio": null,
        "avatar": "https://scontent.cdninstagram.com/a.jpg",
        "url": "https://www.instagram.com/camping.kayla1/",
        "verified": false,
        "metrics": {},
        "id": "camping.kayla1",
        "platform": "instagram",
        "private": false
      },
      {
        "name": "Kayla",
        "handle": "camping.kayla2",
        "bio": null,
        "avatar": "https://scontent.cdninstagram.com/a.jpg",
        "url": "https://www.instagram.com/camping.kayla2/",
        "verified": false,
        "metrics": {},
        "id": "camping.kayla2",
        "platform": "instagram",
        "private": false
      }
    ]
  },
  "page": {
    "next_cursor": null,
    "has_more": false
  },
  "warnings": [],
  "meta": {
    "endpoint": "instagram.users.search",
    "platform": "instagram",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.003",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).

Other Instagram endpoints

Questions

How much does the Instagram account search endpoint cost?

$0.003 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Do I need a platform account?

No. Only public data is read.

A post is the shortcode after /p/ or /reel/, or the link itself; accounts take the username (without the @).

How do I get more items?

When the answer has page.next_cursor, pass it back as cursor for the next page. Each page is billed on its own.

How do I use it from an AI?

Install the MCP server and ask; your AI calls instagram.users.search.