Returns a time series for a concrete metric during a period of time
Request
- Base URL: https://app.metricool.com/api
- URL: https://app.metricool.com/api/v2/analytics/timelines
- Auth: none declared
Query parameters
network Supported values: <ul>
<li>tiktok</li> <li>tiktokads</li> <li>pinterest</li> <li>youtube</li> <li>facebook</li> <li>gmb</li> <li>instagram</li> <li>linkedin</li> <li>twitter</li> <li>twitch</li> </ul>metric Supported values: Metrics are case insensitive<ul>
<li>For TikTokAds: impressions, cost, clicks, conversions, cpm, cpc, ctr</li> <li>For TikTok Videos: videos, views, comments, shares, interactions, likes, reach, engagement, impressionSources, averageVideoViews</li> <li>For TikTok Account: video_views, profile_views, followers_count, followers_delta_count, likes, comments, shares</li> <li>For Pinterest: impression save pin_click outbound_click video_mrc_view video_avg_watch_time video_v50_watch_time quartile_95_percent_view pins</li> <li>For Pinterest (accounts): followers, following, delta followers</li> <li>For Youtube: views, interactions, likes, dislikes, comments, shares </li> <li>For Facebook (metrics for stories): storiesCount <li>For Facebook (metrics for posts): count, interactions, engagement, impressionsunique, impressions, clicks, comments, shares, reactions <li>For Facebook (metrics for reels): blue_reels_play_count, post_impressions_unique, post_video_likes_by_reaction_type, post_video_social_actions, engagement, count </li> <li>For Facebook (account metrics): page_posts_impressions, page_actions_post_reactions_total, postsCount, postsInteractions, likes, pageFollows, pageImpressions, pageImpressions.M, pageImpressions.F, pageImpressions.U, pageImpressions.13-17, pageImpressions.18-24, pageImpressions.25-34, pageImpressions.35-44, pageImpressions.45-54, pageImpressions.55-64, pageImpressions.65+, pageViews, page_daily_follows_unique, page_daily_unfollows_unique</li> <li>For GMB: business_impressions_maps, business_impressions_search, business_impressions_total, business_direction_requests, call_clicks, website_clicks, clicks_total, business_conversations, business_bookings, business_food_orders, business_actions_total</li> <li>For Instagram (account metrics): email_contacts, get_directions_clicks, phone_call_clicks, text_message_clicks, clicks_total, postsCount, postsInteractions, delta_followers, followers_gained, followers_lost</li> <li>For Instagram (posts metrics): count, interactions, engagement, reach, impressions, likes, comments, saves, shares</li> <li>For Instagram (reels metrics): count, comments, likes, saved, shares, engagement, impressions, reach, interactions, videoviews</li> <li>For Instagram (breakdown metrics, correct subject and scope are needed): comments, likes, profile_links_taps, reach, saved, saves, shares, total_interactions, views</li> <li>For Linkedin (account metrics [company]): followers, paidFollowers, companyImpressions, deltaFollowers, impressionCount, shareCount, clickCount, likeCount, commentCount, postsCount</li> <li>For Linkedin (posts metrics [company]): posts, clicks, likes, comments, shares, engagement, impressions, interactions</li> <li>For Linkedin (newsletters metrics [company]): posts, clicks, likes, comments, shares, engagement, impressions, interactions</li> <li>For Linkedin (account metrics [personal]): followers, deltaFollowers, reaction, comment, reshare, impression</li> <li>For Linkedin (posts metrics [personal]): count, comment, reshare, impression, reaction, engagement, interactions</li> <li>For Threads (posts metrics): count, views, likes, replies, reposts, engagement, quotes, interactions, shares</li> <li>For Bluesky (posts metrics): posts_count, interactions, likes, replies, reposts, quotes</li> <li>For Twitter (account metrics): followers, friends, postsCount</li> <li>For Twitch (account metrics): followers, deltaFollowers, subscribers, tier1, tier2, tier3, gifts, videos, views, duration</li> <li>For Twitter (posts metrics): engagement, impressions, interactions, likes, retweets, replies, quotes, profileClicks, linkClicks. Note: this is a per-day rollup under subject=posts, distinct from the tweet-level aggregate 'engagement' returned by subject=tweet on the /aggregation endpoint (used by DataStudio)</li> </ul>From Date and time ISO 8601 format. e.g. 2021-01-01T10:00:00+01:00
From Date and time in ISO 8601 format. e.g. 2021-09-10T03:30:00+01:00
(Optional) The timezone used for the date range to search. ('Europe/Madrid')
Is a filter when we retrieve data. Some examples: 'posts', 'reels', 'account'. Each network defines its own 'subjects'. Mandatory for Instagram, where the valid values are: account, posts, reels, stories, competitors, collabs. For breakdowns the possible subjects are: media_product_type, follow_type and contact_button_type
Is a second filter. Some examples: 'viewed', 'published'. It is used for Youtube and for Instagram metrics breakdown, for the breakdowns the possible values are: BOOK_NOW, CALL, DIRECTION, EMAIL, INSTANT_EXPERIENCE, TEXT, UNDEFINED, FOLLOWER, NON_FOLLOWER, UNKNOWN, AD, CAROUSEL_CONTAINER, POST, REEL, STORY
Response
OK
Changes
No recorded changes to this operation across all 4 revisions of this API.