Инструкция по Instagram API

Instagram API: Публикации — Веб-сведения по короткому коду

Получайте подробные публичные данные по сущности «Публикации» из Instagram по известному идентификатору для карточек, проверки и обогащения.

Операция «Веб-сведения по короткому коду» подходит, когда объект уже найден и продукту нужен его актуальный публичный контекст.

Метод GET
Сущность Публикации
Версии 2
Что делает этот эндпоинт

Что можно сделать с этим API-методом

Сначала оцените результат и сценарии применения, затем переходите к параметрам и рабочему примеру запроса.

Результат запроса

Ответ содержит доступные поля объекта «Публикации» в нормализованной V2 или исходной V1 структуре.

Когда использовать

Операция «Веб-сведения по короткому коду» подходит, когда объект уже найден и продукту нужен его актуальный публичный контекст.

Типовые сценарии использования

Обогащение карточек

Добавляйте публичные поля Instagram к уже известным объектам продукта.

Проверка данных

Сверяйте идентификаторы и актуальный публичный контекст перед дальнейшей обработкой.

Подготовка аналитики

Используйте детали объекта как основу для отчётов, скоринга и связанных запросов.

Доступные версии

Версия ответа

Обе версии решают одну и ту же задачу и принимают одинаковые параметры. Переключатель нужен, чтобы сравнить структуру ответа и выбрать версию, которую ожидает ваш клиент.

Версия ответа V2

Переключайте версии на этой странице, чтобы сравнивать структуру ответа без смены URL инструкции.

Что остается одинаковым

Аутентификация, обязательные параметры и форма запроса одинаковы для V1 и V2. Версия задаётся в пути запроса и определяет структуру ответа.

Что меняется между версиями

Главное отличие — envelope ответа. Для новых интеграций лучше использовать V2, а V1 оставлять только для совместимости с уже существующей клиентской интеграцией.

Как использовать

Как вызвать метод

Для обеих версий используется один заголовок API-ключа и одинаковые параметры строки запроса. Ниже сначала показаны общие параметры, затем путь и примеры кода для выбранной версии.

Входные параметры

Общие параметры
Параметр Обязателен Тип Пример Описание
shortcode Да str DNYwrB-yl0s Короткий код публикации из её публичной ссылки.

Путь запроса для выбранной версии

V2

Версию имеет смысл выбирать, когда вы копируете точный путь эндпоинта, пример URL и фрагмент кода. Список параметров выше при этом остается тем же самым.

GET /api/v2/instagram.com/media/web-details-by-shortcode

Нормализованный формат

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/instagram.com/media/web-details-by-shortcode" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'shortcode=DNYwrB-yl0s'
Пример ответа

Пример ответа по версиям

Пример сокращён до ключевых полей и первых элементов коллекций, чтобы структуру ответа можно было быстро оценить. Переключатель версии меняет формат JSON.

Пример ответа

V2 — JSON

Проверенный пример

Компактный JSON-пример сформирован из последней успешной проверки версии V2.

{
  "success": true,
  "status": "ok",
  "search_context": {
    "shortcode": "DVy5TZMkdgn"
  },
  "data": {
    "content_item": {
      "likes_count": 231962,
      "comment_count": 5417,
      "is_sponsored": false,
      "sponsored_detection_source": null,
      "sponsored_detection_confidence": null,
      "owner": {
        "user_id": "25025320",
        "username": "instagram",
        "name": "Instagram",
        "is_verified": true,
        "is_private": false,
        "avatar_url": "https://example.com/image.jpg"
      },
      "media_id": "3851392652730816551",
      "created_at": "2026-03-12T18:57:10Z",
      "type": "clips",
      "media_type": 2,
      "shortcode": "DVy5TZMkdgn",
      "caption": "timing is impeccable ⁣\n ⁣\n#InTheMoment⁣\n ⁣\nVideo by @f3rnandohh\nMusic by @mikeposner",
      "emails": [],
      "hashtags": [
        "InTheMoment"
      ],
      "is_pinned": null,
      "is_edited": true,
      "is_counts_hidden": false,
      "is_commenting_disabled": null,
      "location": {
        "location_id": null,
        "location_name": null,
        "location_longitude": null,
        "location_latitude": null
      },
      "assets": [
        {
          "id": "3851392652730816551",
          "type": "2",
          "url": "https://instagram.fsjc1-4.fna.fbcdn.net/o1/v/t16/f2/m69/AQPXBOsGmMb5d-lGJptp43z3lgrkVsaZKDBzqYGvl3UY5mCN9mpjKc_2q1YaTsq0Dp8AV_p7T9bnMwVJ-eRRit6t.mp4?strext=1&_nc_cat=105&_nc_oc=…",
          "accessibility_caption": null
        }
      ],
      "usertags": [
        {
          "user_id": "1585457376",
          "username": "f3rnandohh",
          "name": null,
          "is_verified": false,
          "avatar_url": "https://example.com/image.jpg"
        }
      ],
      "coauthor_producers": [],
      "sponsors": [
        {
          "user_id": "1585457376",
          "username": "f3rnandohh",
          "name": null,
          "avatar_url": "https://example.com/image.jpg"
        }
      ]
    }
  }
}
Что делать дальше

Продолжить оценку API-метода

Используйте инструкцию как первую точку принятия решения, а затем переходите к покрытию, стоимости и общим правилам интеграции перед запуском API-метода.

Открыть страницу Instagram API

Сравните соседние сущности, группы API-методов и связанные инструкции перед внедрением.

Открыть страницу платформы

Сравнить стоимость API-методов

Посмотрите, где этот API-метод находится в публичной таблице цен, прежде чем масштабировать использование.

Открыть тарифы

Проверить правила интеграции

Откройте стартовую документацию, чтобы быстро проверить аутентификацию, версионирование, повторы запросов и различия между тестовым и рабочим API.

Открыть документацию
FAQ

Вопросы, которые команды задают до внедрения

Эти ответы помогают понять, подходит ли API-метод под ваш сценарий, выбор версии и запуск.

Какие данные возвращает этот метод Instagram API?

Метод выполняет операцию «Веб-сведения по короткому коду» для сущности «Публикации». Точный набор полей показан в компактном примере ответа ниже.

Какую версию ответа выбрать: V1 или V2?

Для новой интеграции выбирайте V2 с нормализованной структурой. V1 нужен только для совместимости с клиентами, которые уже используют исходный формат платформы.

Что нужно для первого запроса?

Создайте API-ключ, передайте его в заголовке и заполните обязательные параметры из таблицы. Готовые примеры кода уже содержат правильный путь и структуру запроса.