Open in ChatGPT
Coding with AI?
Connect your agent to our MCP and let it integrate any endpoint for you in one shot.

Instagram Users

Search Instagram users by keyword. Returns username, full name, user ID, verification status, privacy status, and profile picture URL.

Endpoint

GET /v1/instagram/users

Price: $0.006 per request Free tier: 50 requests/month

Parameters

Parameter Required Description
query Yes Search keyword (max 500 characters)

Response Fields

Field Type Description
users array Array of matching user profiles
users[].username string Instagram username
users[].full_name string Display name
users[].user_id string Instagram user ID
users[].is_verified boolean Whether the user is verified (blue checkmark)
users[].is_private boolean Whether the account is private
users[].profile_pic_url string URL to profile picture
users[].url string Link to the profile
count integer Total results returned

Example Request

cURL

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

Python

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
}