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?

The Search Users endpoint returns basic profile data for discovery. For detailed profile information including follower counts, use the user data available in the Instagram Posts endpoint results.

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.