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

Instagram API: Истории — Элементы highlight по ID

Получайте данные по сущности «Истории» из Instagram через точечную операцию «Элементы highlight по ID» и подключайте результат к продуктовым процессам.

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

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

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

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

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

Ответ содержит публичные данные «Истории» и служебный контекст, необходимый для последующих API-запросов.

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

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

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

Точечное получение данных

Запрашивайте только нужный объект без загрузки более тяжёлых коллекций.

Обогащение продукта

Добавляйте результат Instagram API в карточки, процессы и внутренние инструменты.

Оркестрация запросов

Используйте ответ как вход для соседних методов и многошаговых сценариев.

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

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

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

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

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

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

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

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

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

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

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

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

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

Общие параметры
Параметр Обязателен Тип Пример Описание
highlight_id Да str 18029499352961095 Unique numerical identifier of a media item inside Instagram Stories Highlights. Required to fetch highlight-specific content. **Example**: `18029499352961095`

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

V2

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

GET /api/v2/instagram.com/stories/highlight-items-by-highlight-id

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

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/instagram.com/stories/highlight-items-by-highlight-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'highlight_id=18029499352961095'
Пример ответа

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

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

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

V2 — JSON

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

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

{
  "success": true,
  "status": "ok",
  "search_context": {
    "highlight_id": "18029499352961095"
  },
  "data": {
    "user": {
      "user_id": "25025320",
      "username": "instagram",
      "name": "Instagram",
      "is_verified": true,
      "is_private": false,
      "avatar_url": "https://example.com/image.jpg"
    },
    "highlight": {
      "count": 44,
      "stories": [
        {
          "media_id": "3818778240853641015",
          "created_at": "2026-01-26T18:57:40Z",
          "type": "story",
          "media_type": 1,
          "video_duration": null,
          "is_sponsored": false,
          "location": {
            "location_id": null,
            "location_name": null,
            "location_short_name": null,
            "location_address": null,
            "location_city": null,
            "location_longitude": null,
            "location_latitude": null
          },
          "story_feed_media": [],
          "assets": [
            {
              "id": "3818778240853641015",
              "type": "1",
              "url": "https://instagram.fsjc1-4.fna.fbcdn.net/v/t51.82787-15/621936830_18696393061001321_4751158615057691379_n.jpg?stp=dst-jpg_e35_p720x720_sh2.08_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=MzgxODc3ODI0MDg1MzY0MTAxNQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnhwaWRzLjExNzAuc2RyLnJlZ3VsYXJfcGhvdG8uQzMifQ%3D%3D&_nc_ohc=PJkQUql406oQ7kNvwGZdlaM&_nc_oc=AdpBQVvk4M9UdUW_QlfyAa1A3BHrserorsgcnSUdBN9rwP-rBghd1jZvRW9TLLzVIso&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fsjc1-4.fna&_nc_gid=f8LMHkinRGZqHXalDymEjg&_nc_ss=7a3ba&oh=00_AQPR701jpahBRSZ9hyTChAkK7tcPFDQkBSre8xo9-zhPBQ&oe=6AD5A64A",
              "accessibility_caption": null
            }
          ]
        },
        {
          "media_id": "3818780515651163017",
          "created_at": "2026-01-26T19:01:58Z",
          "type": "story",
          "media_type": 2,
          "video_duration": 20.9,
          "is_sponsored": false,
          "location": {
            "location_id": null,
            "location_name": null,
            "location_short_name": null,
            "location_address": null,
            "location_city": null,
            "location_longitude": null,
            "location_latitude": null
          },
          "story_feed_media": [],
          "assets": [
            {
              "id": "3818780515651163017",
              "type": "2",
              "url": "https://instagram.fsjc1-4.fna.fbcdn.net/o1/v/t2/f2/m367/AQM9mcxG83JQ52XnJU02cDwdMY38dKRr_Q3WxdWXpVjATvaR4d-ULUmHnQgPZgs9Sf0CLMJ6AAJtQP-MT4gYXBH4NMoyGVCenX-fzVU.mp4?_nc_cat=100&_nc_oc=Adqlsdx_ZnBPTbhDZc7d1u2vJqlF39zVZM3NS1KZYvOyIy2NwbTEchWo3LnR6HWcD80&_nc_sid=5e9851&_nc_ht=instagram.fsjc1-4.fna.fbcdn.net&_nc_ohc=EMWRNFlgylMQ7kNvwH7ZBlC&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uU1RPUlkuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc5Mzg2OTk3NjExMTgzOTgsImFzc2V0X2FnZV9kYXlzIjoyNjEsInZpX3VzZWNhc2VfaWQiOjEwODI2LCJkdXJhdGlvbl9zIjoyMCwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=b544f2862ec5ae80&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8yRTRGMEExNkFDMTdBODRBMENCNUJGMkNDQkEyOTlBQ192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0RBNDFEREVCQUFCQ0Y3MEFFOUFGMUFBODEwMzc1RTlBX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACb8svOv4MndPxUCKAJDMywXQDTmZmZmZmYYEmRhc2hfYmFzZWxpbmVfMV92MREAdegHZZSpAQA&_nc_gid=f8LMHkinRGZqHXalDymEjg&_nc_ss=7a3ba&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQOGwPzJIBbS2Ww-oXk3wfo5mtN5d3igoV_2Ri62kjDA0A&oe=6AD5AFE9",
              "accessibility_caption": null
            }
          ]
        },
        {
          "_more_items": 42
        }
      ]
    }
  }
}
Что делать дальше

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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