Meta обновява Instagram Graph API и Marketing API с нови обекти, полета и метрики

Meta обяви серия от промени в Instagram Graph API и Marketing API, насочени към опростяване на разработката и по-добра яснота на данните. Актуализациите включват премахване на стари крайни точки, нови полета и промени в метриките за анализ.

Разработчиците имат срок до 21 януари 2026 г. за миграция на засегнати крайни точки в Marketing API и до 21 април 2025 г. за обновяване на крайни точки в Graph API.

Преход от legacy обекти към IG User/IG Media/IG Comment

Ключов елемент е замяната на по-старите обекти Instagram User, Instagram Media, Instagram Carousel и Instagram Comment с актуалните IG User, IG Media и IG Comment. Идеята е да се запази функционалност за повечето сценарии, като същевременно отпаднат дублиращи се или остарели полета.

Пример за промени при медийните обекти: Instagram Media вече няма да поддържа полета като filter_name, location, latitude и longitude. При carousel съдържание отпадат permalink и caption за child media.

Нови полета и именуване при IG User и съдържание

Обектът IG User получава нови полета като has_profile_picture и is_published, както и edges като /authorized_adaccounts, /agencies и /upcoming_events, които целят по-пълна картина за интеграции и бизнес употреба.

Има и промени в имената на някои ключови полета:

• follow_count → follows_count
• followed_by_count → followers_count
• profile_pic → profile_picture_url

Част от промените не са просто „преименуване“ — при някои обекти отпадат данни (например caption за carousel child media), което може да изисква промени в логиката на приложенията.

При медийните обекти се въвеждат и съпоставяния между старите и новите полета:

• taken_at (в Instagram Media) съответства на timestamp (в IG Media)
• caption_text се уеднаквява с caption, но caption за child елементи в carousel вече няма да е наличен
• display_url и video_url се обединяват в media_url

Полето content_type променя формата си: вместо цяло число започва да връща enum стойност като низ (например 0 → IMAGE, 1 → VIDEO, 4 → BROADCAST, 8 → CAROUSEL_ALBUM).

Промени при коментари и преходни ID полета

За Instagram Comment е важно, че полето instagram_user се заменя с user, което вече връща IG User вместо Instagram User.

За улесняване на миграцията Meta въвежда преходни ID полета: ig_user_id, ig_media_id и ig_comment_id. Те ще останат налични до 21 април 2025 г., след което се очаква преминаване към новите обекти без нужда от тези мостови идентификатори.

Marketing API и Graph API: крайни точки, които спират legacy поддръжка

В Marketing API полета като instagram_actor_id и instagram_story_id се заменят съответно с instagram_user_id и instagram_media_id. Освен това всеки edge, който преди е връщал Instagram User, ще връща IG User.

От 21 януари 2026 г. редица крайни точки в Marketing API вече няма да поддържат legacy обекти, включително:

• /generatepreviews
• /act_<adaccount_id>/generatepreviews
• различни крайни точки за рекламни кампании, creatives и async ad requests

При Graph API legacy обектите се прекратяват след 21 април 2025 г. Това засяга крайни точки за извличане на Instagram потребители, медия, коментари и carousels, както и управление на Instagram акаунти, свързани с Facebook Pages и бизнес активи.

Insights API: „views“ става водеща метрика, стари метрики отпадат

Meta променя и логиката за измерване на потреблението на съдържание. „Views“ се утвърждава като основна метрика за представяне на reels, live видеа, снимки, carousels и stories. От API v22 метриката views ще е налична както за media insights, така и за user insights.

За user insights се добавя поддръжка на views с многоизмерни breakdown-и по тип последовател (follower type) и тип медиен продукт (media product type).

С v22 се планира прекратяване на по-стари метрики, включително:

• plays
• clips_replays_count
• ig_reels_aggregated_all_plays_count
• impressions (за media и user insights, с уточнение за медия)

Метриката impressions се прекратява за медийно съдържание, създадено на или след 2 юли 2024 г. За по-стари публикации API ще продължи да връща стойности за impressions по досегашния начин.

Какво означава това

• Разработчиците трябва да планират миграция от legacy обекти към IG User, IG Media и IG Comment в рамките на посочените срокове, за да избегнат прекъсвания.
• Някои полета отпадат напълно (напр. локационни данни при Instagram Media), което може да изисква промяна в функционалности и отчети.
• Обединяването на display_url/video_url в media_url и преминаването на content_type към enum улесняват обработката, но изискват адаптация на парсването.
• Преминаването към views променя KPI рамката: отчети и табла, базирани на plays или impressions, ще трябва да се актуализират.
• Преходните ID полета (ig_user_id, ig_media_id, ig_comment_id) дават кратък прозорец за поетапна миграция, но след това няма да са налични.