Skip to main content
Skip table of contents

Migrate from the Emplifi/Socialbakers API 1.0 to 3.0

This guide will help you understand the migration from API 1.0 (v1) to 2.0 (v2) and ultimately, 3.0 (v3).

The lists on this page only include metrics that have to be migrated between the API versions.

You can find all metrics available in the Emplifi API, in the documentation here. Ensure that you review the latest and most recent documentation (v3). Simply select the version at the top-right corner in the introduction of the API documentation:

How to use this guide

This guide features tables for individual social media platforms displaying the following details:

  • The old names of metrics (version 1.0)
    the names of the metrics as found in the API v1

  • The new names of metrics (3.0)
    On version 2.0, new names were given to most of the metrics (presented in the tables below) due to a better arrangement of the metrics in the API documentation.

  • New dimensions (3.0)
    A whole new set of dimensions has been introduced in the API v2. Previously (v1), the aggregated post metrics were aggregated per day (date.day), but now you can choose between a whole new set. Check the example below:

    mceclip1.png
  • New sections (3.0)
    At which section of the 3.0 (and 2.0) documentation you can find the metric. New sections have been introduced.

  • New API Metrics
    Content Hub metrics were introduced with v3.

Example

We review example of the first two metrics in the Facebook Table below. Their old names are:

  • comments

  • comments_by_type

They have, however, an identical new name:

  • number_of_comments

In version 1.0, both metrics had different names (comments & comments_by_type). In version 3.0 (and 2.0), both have the same name number_of_comments. To differentiate between them, and to aggregate the comments by their type, it is necessary to include the media_type on top of the other requested dimension. Check the our API documentation for a better understanding.

Why All New Dimensions are Not Included in the Boards Below

For each table below, the results presented show you how to obtain the same results as in v1. So, to get the aggregation of comments per day, you need to use the dimension date.day.

 If you want to know how to get started with the Emplifi API, check out Integrate the Public Emplifi API into Your Application

Migrated Facebook metrics

Old metric name

New metric name

New dimension

New section

comments

number_of_comments

date.day

Aggregated Post Metrics

comments_by_type

number_of_comments

date.day, media_type

Aggregated Post Metrics

engagement_rate

engagement_rate

date.day

Aggregated Post Metrics

fans_change

fans_change

date.day

Profile Metrics

fans_lifetime

fans_lifetime

date.day

Profile Metrics

interactions

interactions

date.day

Aggregated Post Metrics

interactions_by_type

interactions

date.day, media_type

Aggegated Post Metrics

interactions_per_1000_fans

interactions_per_1k_fans

date.day

Aggegated Post Metrics

interactions_per_1000_fans_by_type

interactions_per_1k_fans

date.day, media_type

Aggregated Post Metrics

page_posts

page_posts

date.day

Aggegated Post Metrics

page_posts_by_type

page_posts

date.day, media_type

Aggregated Post Metrics

reactions

likes

date.day

Aggregated Post Metrics

shares

shares

date.day

Aggregated Post Metrics

shares_by_type

shares

date.day, media_type

Aggregated Post Metrics

user_posts

user_posts

date.day

Aggregated Post Metrics

user_posts_average_response_time

user_posts_average_response_time

date.day

Aggregated Post Metrics

user_posts_responded

user_posts_responded

date.day

Aggregated Post Metrics

user_posts_responded_by_time

user_posts _responded

date.day, response_time

Aggregated Post Metrics

user_posts_response_rate

user_posts_response_rate

date.day

Aggregated Post Metrics

user_questions

user_questions

date.day

Aggregated Post Metrics

user_questions_average_response_time

User_questions_average_response_time

date.day

Aggregated Post Metrics

user_questions_responded

user_questions_responded

date.day

Aggregated Post Metrics

user_questions_responded_by_time

user_questions_responded

date.day, response_ time

Aggregated Post Metrics

user_questions_response_rate

user_questions_response_rate

date.day

Aggregated Post Metrics

insights_activity

insights_activity

date.day

Profile Metrics

insights_activity_by_activity_type

insights_activity

date.day, activity_type

Profile Metrics

insights_activity_unique

insights_activity_unique

date.day

Profile Metrics

insights_activity_unique_by_activity_type

insights_activity_unique

date.day, activity_type

Profile Metrics

insights_activity_unique_by_age_gender

insights_activity_unique

date.day, gender_age

Profile Metrics

insights_activity_unique_by_city

insights_activity_unique

date.day, city

Profile Metrics

insights_activity_unique_by_country

insights_activity_unique

date.day, country

Profile Metrics

insights_activity_unique_by_locale

insights_activity_unique

date.day, locale

Profile Metrics

insights_engaged_users

insights_engaged_users

date.day

Profile Metrics

insights_fan_adds

insights_fan_ adds

date.day

Profile Metrics

insights_fan_adds_unique

insights_fan_adds_unique

date.day

Profile Metrics

insights_fan_removes

insights_fan_removes

date.day

Profile Metrics

insights_fan_removes_unique

insights_fan_removes_unique

date.day

Profile Metrics

insights_fans_by_like_source

insights_fan_adds

date.day, like_ source

Profile Metrics

insights_fans_by_like_source_unique

insights_fan_adds_unique

date.day, like_source

Profile Metrics

insights_fans_by_unlike_source_unique

insight_fans_remove_unique

date.day, unlike_ source

Profile Metrics

insights_fans_city

insights_fans_lifetime

date.day, City

Profile Metrics

insights_fans_gender_age_lifetime

insights_fans_lifetime

date.day, gender_age

Profile Metrics

insights_fans_lifetime

insights_fans_lifetime

date.day

Profile Metrics

insights_fans_lifetime_by_country

insights_fans_lifetime

date.day, country

Profile Metrics

insights_fans_locale_lifetime

insights_fans_lifetime

date.day, locale

Profile Metrics

insights_fans_online

insights_fans_online

date.day

Profile Metrics

insights_fans_online_by_hour

insights_fans_online

date.day, hour_of_day

Profile Metrics

insights_impressions

insights_impressions

date.day

Profile Metrics

insights_impressions_by_paid_non_paid

insights_impressions

date.day, post_attribution

Profile Metrics

insights_impressions_organic

insights_impressions

date.day, post_attribution

Profile Metrics

insights_impressions_paid

insights_impressions

date.day, post_attribution

Profile Metrics

insights_positive_feedback

insights_positive_feedback

date.day

Profile Metrics

insights_post_clicks

insights_post_clicks

date.day

Profile Metrics

insights_post_clicks_by_type

insights_post_clicks

date.day, click_type

Profile Metrics

insights_post_clicks_unique

insights_post_clicks_unique

date.day

Profile Metrics

insights_post_clicks_unique_by_type

insights_post_clicks_unique

date.day, click_type

Profile Metrics

insights_post_impressions

insights_post_impressions

date.day

Profile Metrics

insights_post_impressions_by_paid_non_paid

insights_post_impressions

date.day, post_attribution

Profile Metrics

Insights_post_impressions_frequency_distribution

insights_post_reach

date.day, frequency_distribution

Profile Metrics

insights_post_impressions_paid

insights_post_impressions

date.day, post_attribution

Profile Metrics

insights_post_reach

insights_post_reach

date.day

Profile Metrics

insights_post_reach_by_paid_non_paid

insights_post_reach

date.day, post_attribution

Profile Metrics

insights_post_reach_organic

insights_post_reach

date.day, post_attribution

Profile Metrics

insights_post_reach_paid

insights_post_reach

date.day, post_attribution

Profile Metrics

insights_reach

insights_reach

date.day

Profile Metrics

insights_reach_by_age_gender

insights_ reach

date.day, gender age

Profile Metrics

insights_reach_by_paid_non_paid

insights_reach

date.day, post_attribution

Profile Metrics

insights_28_days_reach

insights_28_days_reach

date.day

Profile Metrics

insights_7_days_reach

insights_7_days_reach

date.day

Profile Metrics

insights_reach_engagement

insights_reach_engagement

date.day

Profile Metrics

insights_reach_organic

insights_reach

date.day, post_attribution

Profile Metrics

insights_reach_paid

insights_reach

date.day, post_attribution

Profile Metrics

insights_post_engagement

insights_reactions

date.day

Profile Metrics

insights_reactions_by_type

insights_reactions

date.day, reaction_type

Profile Metrics

insights_video_complete_views_30s

insights_video_complete_views_30s

date.day

Profile Metrics

Insights_video_complete_views_30s_autoplayed

insights_video_complete_views_30s

date.day, play_type

Profile Metrics

insights_video_complete_views_30s_click_to_play

insights_video_complete_views_30s

date.day, play_type

Profile Metrics

insights_video_complete_views_30s_organic

insights_video_complete_views_30s

date.day, post_attribution

Profile Metrics

Insights_video_complete_views_30s_repeat_views

insights_video_complete_views_30s_repeat_views

date.day

Profile Metrics

insights_video_complete_views_30s_unique

insights_video_complete_views_30s_unique

date.day

Profile Metrics

insights_video_repeat_views

insights_video_repeat_views

date.day

Profile Metrics

insights_video_views

insights_video_views

date.day

Profile Metrics

insights_video_views_autoplayed

insights_video_views

date.day, play_type

Profile Metrics

insights_video_views_click_to_play

insights_video_views

date.day, play_type

Profile Metrics

insights_video_views_organic

insights_video_views

date.day, post_attribution

Profile Metrics

insights_video_views_paid

insights_video_views

date.day, post _attribution

Profile Metrics

insights_video_views_unique

insights_video_views_unique

date.day

Profile Metrics

insights_views

insights_views

date.day

Profile Metrics

Deprecated Facebook metrics

Old metric name

Status

comments_by_ppd_status

Deprecated

interactions_by_ppd_status

Deprecated

page_posts_by_app

Deprecated

page_posts_by_ppd_status

Deprecated

reactions_by_ppd_status

Deprecated

reactions_by_reaction_type

Deprecated

shares_by_ppd_status

Deprecated

user_posts_by_app

Deprecated

insights_impressions_viral

Deprecated

Insights_impressions_viral_frequency_distribution

Deprecated

Insights_fan_adds_by_paid_non_paid_unique

Deprecated

insights_reach_viral

Deprecated

story

Deprecated

insights_negative_feedback (not unique)

Deprecated

insights_engaged_fan

Deprecated

insights_impressions_fan

Deprecated

insights_reach_fan

Deprecated

insights_reactions_like_total

Deprecated

insights_video_retention_graph

Deprecated

Migrated Instagram metrics

Old metric name

New metric name

New Dimension

New section

comments

number_of_comments

date.day

Aggregated Post Metrics

comments_by_type

number_of_comments

date.day, media_type

Aggregated Post Metrics

engagement_rate

engagement_rate

date.day

Aggregated Post Metrics

followers_change

followers_change

date.day

Profile Metrics

followers lifetime

followers_lifetime

date.day

Profile Metrics

following_change

following_change

date.day

Profile Metrics

following_lifetime

following_lifetime

date.day

Profile Metrics

interactions

interactions

date.day

Aggregated Post Metrics

interactions_by_type

interactions

date.day, media_type

Aggregated Post Metrics

interactions_per_1000_followers

interactions_per_1k_fan

date.day

Aggregated Post Metrics

interactions_per_1000_followers_by_type

interactions_per_1k_fan

date.day

Aggregated Post Metrics

likes

likes

date.day

Aggregate Post Metrics

likes_by_post_type

likes

date.day, media_type

Aggregate Post Metrics

profile_posts

page_posts

date.day

Aggregate Post Metrics

profile_posts_by_type

page posts

date.day, media_type

Aggregate Post Metrics

insights_followers_by_city_by_day

insights_followers

date.day, city

Profile Metrics

insights_followers_by_country_by_day

insights_followers

date.day, country

Profile Metrics

insights_followers_by_gender_by_age_by_day

insights_followers

date.day, gender_age

Profile Metrics

insights_followers_by_locale_by_day

insights_followers

date.day, locale

Profile Metrics

insights_post_engagement_by_day

insights_engagements

date.day

Aggregated Post Metrics

insights_post_engagement_by_type_by_day

insights_engagements

date.day, media_type

Aggregated Post Metrics

insights_post_impressions_by_day

insights_impressions

date.day

Aggregated Post Metrics

insights_post_impressions_by_type_by_day

insights_impressions

date.day, media_type

Aggregated Post Metrics

insights_post_interactions_by_day

interactions

date.day

Aggregated Post Metrics

insights_post_interactions_by_int_type_by_day

interactions

date.day, interaction_type

Aggregated Post Metrics

insights_post_saves_by_day

insights_post_saves

date.day

Aggregated Post Metrics

insights_post_saves_by_type_by_day

insights_post_saves

date.day, media_type

Aggregated Post Metrics

insights_post_video_views_by_day

insights_video_views

date.day

Aggregated Post Metrics

insights_profile_all_clicks_by_day

insights_profile_clicks

date.day

Profile Metrics

insights_profile_email_contacts_by_day

insights_profile_clicks

date.day, click_target

Profile Metrics

insights_profile_get_directions_clicks_by_day

insights_profile_clicks

date.day, click_target

Profile Metrics

insights_profile_impressions_by_day

insights_impressions

date.day

Aggregated Post Metrics

insights_profile_phone_call_clicks_by_day

insights_profile_clicks

date.day, click_target

Profile Metrics

insights_profile_reach_by_day

insights_reach_per_content

date.day

Aggregated Post Metrics

insights_profile_text_message_clicks_by_day

insights_profile_clicks

date.day, click target

Profile Metrics

insights_profile_views_by_day

insights_profile_views

date.day

Profile Metrics

insights_profile_website_clicks_by_day

insights_profile_clicks

date.day, click target

Profile Metrics

Deprecated Instagram metrics

Old metric name

Status

insights_post_video_views_by_type_by_day

Deprecated

comments_by_image_filter

Deprecated

comments_by_video_filter

Deprecated

interactions_by_image_filter

Deprecated

interactions_by_video_filter

Deprecated

interactions_per_1000_followers_by_ image_filter

Deprecated

interactions_per_1000_followers_by_video_filter

Deprecated

likes_by_ image_filter

Deprecated

likes_by_video_filter

Deprecated

profile_posts_by_image_filter

Deprecated

profile_posts_by_video_filter

Deprecated

Migrated Twitter metrics

Old metric name

New metric name

New dimension

New section

ff _ratio

ff_ratio

date.day

Profile Metrics

followers_change

followers_change

date.day

Profile Metrics

followers_lifetime

followers_lifetime

date.day

Profile Metrics

following_change

following_change

date.day

Profile Metrics

following _lifetime

following_lifetime

date.day

Profile Metrics

incoming

user_posts

date.day

Aggregated Post Metrics

incoming_questions

user questions

date.day

Aggregated Post Metrics

incoming_questions_average_response_time

user_posts_average_response_time

date.day

Aggregated Post Metrics

incoming_questions_responded

user questions responded

date.day

Aggregated Post Metrics

incoming_questions_responded_by_time

user_questions_responded

date.day, response_time

Aggregated Post Metrics

incoming_questions_response_rate

user_questions_response_rate

date.day

Aggregated Post Metrics

incoming_tweets

user_posts

date.day, content_type

Aggregated Post Metrics

incoming_tweets_average_response_time

user_posts_average_response_time

date.day

Aggregated Post Metrics

incoming_tweets_responded

user_posts_responded

date.day

Aggregated Post Metrics

incoming_tweets_responded_by_time

user_posts_responded

date.day, response_time

Aggregated Post Metrics

incoming_tweets_response_rate

user_posts_response_rate

date.day

Aggregated Post Metrics

interactions

interactions

date.day

Aggregated Post Metrics

interactions_per_1000_followers

interactions_per_1k_fans

date.day

Aggregated Post Metrics

likes

likes

date.day

Aggregated Post Metrics

listed change

listed _change

date.day

Profile Metrics

listed lifetime

listed lifetime

date.day

Profile Metrics

profile_activities

page_posts

date.day

Aggregated Post Metrics

profile_replies

page_replies

date.day

Aggregated Post Metrics

profile_retweets

page_shares

date.day

Aggregated Post Metrics

profile_tweets

profile_tweets

date.day

Aggregated Post Metrics

replies

number_of_comments

date.day

Aggregated Post Metrics

retweets

shares

date.day

Aggregated Post Metrics

Deprecated Twitter metrics

Old metric name

Status

profile_activities_by_app

Deprecated

incoming_replies

Deprecated

incoming_retweets

Deprecated

Migrated Youtube metrics

Old metric name

New metric name

New dimension

New section

comments_change

interaction_change

date.day, interaction_type

Profile Metrics

dislikes_change

interaction_change

date.day, interaction_type

Profile Metrics

engagement_rate

engagement_rate

date.day

Aggregated Post Metrics

interaction_change

interaction_change

date.day

Profile Metrics

interactions_per_1000_subscribers

interactions_per_1k_fans

date.day

Profile Metrics

likes_change

interaction_change

date.day, interaction_type

Profile Metrics

subscribers_change

subscribers_change

date.day

Profile Metrics

subscribers_count_lifetime

subscribers_ lifetime

date.day

Profile Metrics

video_count_lifetime

video_lifetime

date.day

Profile Metrics

viewed_time_change

viewed_time_change

date.day

Profile Metrics

views_change

views_change

date.day

Profile Metrics

Youtube deprecated metrics

Old metric name

Status

views_count_lifetime

Deprecated

viewed_time_lifetime

Deprecated

video_change

Deprecated

Migrated Pinterest metrics

Old metric name

New metric name

New dimension

New section

boards_change

boards_change

date.day

Profile Metrics

boards_lifetime

boards_lifetime

date.day

Profile Metrics

comments

number_of_comments

date.day

Aggregated Post Metrics

followers_change

followers_change

date.day

Profile Metrics

followers_lifetime

followers_lifetime

date.day

Profile Metrics

following_change

following_change

date.day

Profile Metrics

following_lifetime

following_lifetime

date.day

Profile Metrics

interactions

interactions

date.day

Aggregated Post Metrics

likes

likes

date.day

Aggregated Post Metrics

pins_change

page_posts

date.day

Aggregated Post Metrics

pins_lifetime

pins lifetime

date.day

Profile Metrics

repins

interactions

interaction_type

Aggregated Post Metrics

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.