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

Instagram API: Обзор — Медиа по fit ID

Находите объекты сущности «Обзор» в Instagram по пользовательскому запросу и подключайте результаты к поиску, каталогу или исследовательскому интерфейсу.

Операция «Медиа по fit ID» нужна, когда точный ID объекта ещё неизвестен и сначала требуется найти подходящие результаты.

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

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

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

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

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

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

Операция «Медиа по fit ID» нужна, когда точный ID объекта ещё неизвестен и сначала требуется найти подходящие результаты.

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

Поиск в продукте

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

Формирование каталога

Находите кандидатов по запросам и сохраняйте релевантные объекты для дальнейшего обогащения.

Исследование рынка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Общие параметры
Параметр Обязателен Тип Пример Описание
fit_id Да str 10155868806390727 Instagram fit identifier for logged-out explore media feeds. Example: 10155868806390727.
cursor Нет str | None next-page-cursor Курсор следующей страницы из предыдущего ответа. Не передавайте его для первой страницы.
num_media Нет int 20 Requested number of media items to return. Example: 20.

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

V2

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

GET /api/v2/instagram.com/explore/media-from-fit-by-fit-id

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

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/instagram.com/explore/media-from-fit-by-fit-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'fit_id=10155868806390727' \
  # Optional parameters:
  # --data-urlencode 'cursor=next-page-cursor'
  # --data-urlencode 'num_media=20'
Пример ответа

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

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

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

V2 — JSON

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

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

{
  "success": true,
  "status": "ok",
  "pagination": {
    "has_more": true,
    "cursor": "QVFB..."
  },
  "search_context": {
    "fit_id": "10155868806390727",
    "num_media": 20
  },
  "data": {
    "fit_id": "10155868806390727",
    "title": "Sports",
    "count": 20,
    "timeline": [
      {
        "likes_count": 13050,
        "comment_count": 88,
        "reshare_count": null,
        "play_count": null,
        "is_sponsored": false,
        "sponsored_detection_source": null,
        "sponsored_detection_confidence": null,
        "owner": {
          "user_id": "73015619522",
          "username": "animexronin",
          "name": "Anime Ronin | Explore Anime Content",
          "is_verified": false,
          "is_private": false,
          "has_public_story": false,
          "account_type": 3,
          "avatar_url": "https://example.com/image.jpg"
        },
        "media_id": "4001623464176169074",
        "created_at": "2026-10-06T01:38:31Z",
        "type": "carousel_container",
        "media_type": 8,
        "shortcode": "DeIn1bTFrBy",
        "video_duration": null,
        "caption": "If you’re looking for sports anime with 100+ episodes, long-running rivalries, intense matches, and plenty of time to get attached to the characters, these are worth adding to y…",
        "emails": [],
        "hashtags": [
          "anime",
          "animerecommendation",
          {
            "_more_items": 3
          }
        ],
        "is_edited": false,
        "is_counts_hidden": false,
        "is_commenting_disabled": null,
        "location": {
          "location_id": null,
          "location_name": null,
          "location_short_name": null,
          "location_address": null,
          "location_city": null,
          "location_longitude": null,
          "location_latitude": null
        },
        "assets": [
          {
            "id": "4001622817555635243",
            "type": "1",
            "url": "https://scontent-sea5-1.cdninstagram.com/v/t51.82787-15/836406312_17921865996435523_3656085764139413244_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=111&ig_cache_key=NDAwMTYyMjgxNzU1NTYzNT…",
            "accessibility_caption": null
          },
          {
            "id": "4001622817936450748",
            "type": "1",
            "url": "https://scontent-sea5-1.cdninstagram.com/v/t51.82787-15/838090355_17921865987435523_7272725956506627016_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=107&ig_cache_key=NDAwMTYyMjgxNzkzNjQ1MD…",
            "accessibility_caption": null
          },
          {
            "_more_items": 4
          }
        ],
        "sponsors": [],
        "coauthor_producers": []
      },
      {
        "likes_count": 332,
        "comment_count": 19,
        "reshare_count": null,
        "play_count": null,
        "is_sponsored": false,
        "sponsored_detection_source": null,
        "sponsored_detection_confidence": null,
        "owner": {
          "user_id": "55694888538",
          "username": "section__104",
          "name": "Section 104",
          "is_verified": false,
          "is_private": false,
          "has_public_story": false,
          "account_type": 3,
          "avatar_url": "https://example.com/image.jpg"
        },
        "media_id": "3359099726492392163",
        "created_at": "2024-05-02T13:18:41Z",
        "type": "feed",
        "media_type": 2,
        "shortcode": "C6d62dqsNrj",
        "video_duration": 41.26499938964844,
        "caption": "TBT @14gump going crazy against Columbus just ask Chuck 😂…but we want to hear yall thoughts did he go crazy yeah🙂‍↕️ or na🙂‍↔️ drop a comment below👇🏾👇🏾👇🏾 #Commentary #Miam #Miam…",
        "emails": [],
        "hashtags": [
          "Commentary",
          "Miam",
          {
            "_more_items": 15
          }
        ],
        "is_edited": false,
        "is_counts_hidden": false,
        "is_commenting_disabled": null,
        "location": {
          "location_id": null,
          "location_name": null,
          "location_short_name": null,
          "location_address": null,
          "location_city": null,
          "location_longitude": null,
          "location_latitude": null
        },
        "assets": [
          {
            "id": "3359099726492392163",
            "type": "2",
            "url": "https://scontent-sea5-1.cdninstagram.com/o1/v/t16/f2/m69/AQNG_DMWfqiMiih-47KyyAyYThMhHX9YhTtEgDq9kGf2zoUsY8Zq_86SbHZRMDIYw1JuSRLPZw-ileNTFGm9n8x-.mp4?strext=1&_nc_cat=102&_nc_si…",
            "accessibility_caption": null
          }
        ],
        "sponsors": [],
        "coauthor_producers": []
      },
      {
        "_more_items": 18
      }
    ],
    "topic_pills": [
      {
        "topic_id": "297639340888807",
        "title": "Fitness Competitions"
      },
      {
        "topic_id": "519683409871768",
        "title": "Sports Roles"
      },
      {
        "_more_items": 26
      }
    ]
  }
}
Что делать дальше

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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