دریافت اطلاعات کامل اکانت اینستاگرام

با استفاده از این وب سرویس میتوانید از اینستاگرام اطلاعات کاربر مورد نظر را به طور کامل دریافت کنید.

مشخصات

مشخصه	مقدار
دسته‌بندی	اطلاعات
وضعیت	فعال
نسخه API	apis-1
فرمت پاسخ	JSON
آدرس پایه	https://open.nestapi.ir
مسیر	/apis-1/instagram-profile-viewer
لینک کامل	https://open.nestapi.ir/apis-1/instagram-profile-viewer

متدهای HTTP

متد	مسیر	نوع ورودی
GET	/apis-1/instagram-profile-viewer	Query String

پارامترها

پارامترهای Query String

نام	نوع	الزامی	پیش‌فرض	توضیحات
username	string	بله	—	نام کاربری اینستاگرام با یا بدون @، یا آدرس کامل پروفایل، مثلاً cristiano؛ هنگام استفاده از action=search لازم نیست
url	string	خیر	—	آدرس کامل پروفایل اینستاگرام (جایگزین username)
action	string	خیر	profile	نوع داده: profile (مشخصات و آمار پروفایل)، posts (پست‌های اخیر)، stories (استوری‌های فعال)، reels (ریلزها با لینک مستقیم MP4)، highlights (هایلایت‌ها)، search (جستجوی کاربران) یا all (همهٔ بخش‌ها)
q	string	خیر	—	عبارت جستجو هنگام استفاده از action=search، مثلاً ronaldo

نمونه درخواست

مشاهده کامل مشخصات پروفایل

لینک مستقیم

GET https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->instagramProfileViewer(username: 'cristiano');

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.instagram_profile_viewer(username="cristiano")

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.instagramProfileViewer({ username: "cristiano" });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

دریافت استوری‌های فعال

لینک مستقیم

GET https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano&action=stories

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano&action=stories"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->instagramProfileViewer(username: 'cristiano', action: 'stories');

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.instagram_profile_viewer(username="cristiano", action="stories")

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.instagramProfileViewer({ username: "cristiano", action: "stories" });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

دریافت ریلزها همراه با لینک مستقیم دانلود ویدیو

لینک مستقیم

GET https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano&action=reels

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano&action=reels"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->instagramProfileViewer(username: 'cristiano', action: 'reels');

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.instagram_profile_viewer(username="cristiano", action="reels")

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.instagramProfileViewer({ username: "cristiano", action: "reels" });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

دریافت پست‌های اخیر

لینک مستقیم

GET https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano&action=posts

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano&action=posts"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->instagramProfileViewer(username: 'cristiano', action: 'posts');

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.instagram_profile_viewer(username="cristiano", action="posts")

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.instagramProfileViewer({ username: "cristiano", action: "posts" });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

جستجوی نام کاربری یا سلبریتی‌ها

لینک مستقیم

GET https://open.nestapi.ir/apis-1/instagram-profile-viewer?action=search&q=ronaldo

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/instagram-profile-viewer?action=search&q=ronaldo"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->instagramProfileViewer(action: 'search', q: 'ronaldo');

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.instagram_profile_viewer(action="search", q="ronaldo")

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.instagramProfileViewer({ action: "search", q: "ronaldo" });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

دریافت تجمیعی همه بخش‌ها (پروفایل + استوری + ریلز + پست + هایلایت)

لینک مستقیم

GET https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano&action=all

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/instagram-profile-viewer?username=cristiano&action=all"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->instagramProfileViewer(username: 'cristiano', action: 'all');

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.instagram_profile_viewer(username="cristiano", action="all")

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.instagramProfileViewer({ username: "cristiano", action: "all" });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

کدهای خطا

کد	وضعیت	علت
NOT_FOUND	404	مسیر وجود ندارد، یا متد روی آن ثبت نشده
PARAM_NOT_FOUND	400	پارامتر لازم ارسال نشده
VALIDATION_ERROR	422	پارامتر آمده ولی نوع، قالب یا بازه‌اش نادرست است
USER_NOT_FOUND	404	حساب کاربری مورد نظر در اینستاگرام یافت نشد
INVALID_FILE_HASH	400	مقدار هش پارامتر file معتبر نیست
MEDIA_NOT_FOUND	404	فایل رسانه درخواستی یافت نشد یا منقضی شده است
SERVICE_UNAVAILABLE	502	خطا در برقراری ارتباط با سرویس واکشی اطلاعات اینستاگرام

لینک های بیشتر

• راهنمای اتصال به سرویس
• فرمت خروجی موفقیت API
• فرمت خروجی خطای API
• کدهای خطای عمومی