Instagram Search Users API

Endpoint

GET /v1/instagram/users

Parameters

query *

Search keyword (max 500 characters)

Response fields

users

Array of matching user profiles

username

Instagram username

full_name

Display name

user_id

Instagram user ID

is_verified

Whether the user is verified (blue checkmark)

is_private

Whether the account is private

profile_pic_url

URL to profile picture

url

Link to the profile

count

Total results returned

Example Request

curl "https://apidirect.io/v1/instagram/users?query=photography" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/instagram/users",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "photography"}
)
print(response.json())

Example Response

{
  "users": [
    {
      "username": "natgeo",
      "full_name": "National Geographic",
      "user_id": "787132",
      "is_verified": true,
      "is_private": false,
      "profile_pic_url": "https://scontent.cdninstagram.com/.../photo.jpg",
      "url": "https://instagram.com/natgeo"
    }
  ],
  "count": 50
}

Frequently asked questions

What user data is returned?

Each result includes username, full name, user ID, verification status (blue checkmark), privacy status, profile picture URL, and a direct link to the profile.

How many users are returned?

Each request returns up to 50 user results.

Can I see follower counts and bios?

Search Users returns basic discovery data only. For full profile details — bio, follower / following counts, media count, category, and external link — use the User Profile endpoint.

How does pricing work?

You only pay for successful requests. The Instagram Search Users API costs $0.006 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.