Minter.io API

The Minter.io API allows you to extend the functionality of our social media analytics tool to manage and build powerful reporting for your unique business needs.
With our API you can access all your analytics data in Minter.io and integrate it into your own analytics dashboards, build custom reports or calculate business-specific metrics.
The API is available for Instagram profiles and hashtags, Twitter profiles and hashtags, Facebook pages, TikTok profiles and LinkedIn pages.
Access to the API is only available with our Agency plans.

Base url
https://api.minter.io/v1.0

Authentication

To connect to our API, you must use the access token. This can be obtained from your dashboard, under Settings -> Access token. Your access token has complete access to your account, so please protect it.

Example

Simple python script to export your Minter.io data. See on github.com.

Get User

Get information about current user.

Parameters

  • No parameters.
GET /users/self
curl https://api.minter.io/v1.0/users/self \
  -H "Authorization: Bearer ACCESS_TOKEN"

List Reports

Get a list of all available reports.

Parameters

  • No parameters.
GET /reports/
curl https://api.minter.io/v1.0/reports/ \
  -H "Authorization: Bearer ACCESS_TOKEN"

Get Report

Get information about a report.

URL Parameters

  • report_id string required

    The ID of the report.

GET /reports/{report_id}
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Create Report

Create a report for an Instagram User or Instagram Hashtag.

Body Parameters

  • username string

    Instagram username (Business accounts only).

  • hashtag string

    Instagram hashtag.

POST /reports/
curl https://api.minter.io/v1.0/reports/ \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"username":"nike"}' \
  -X POST

Delete Report

Remove a report.

URL Parameters

  • report_id string required

    The ID of the report.

DELETE /reports/{report_id}
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225 \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE

Instagram: Followers

The number of profile's Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/followers/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/followers/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Follower Change

The absolute increase or decrease in Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/followers/change
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/followers/change?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Gained and Lost Followers

The number of Followers gained and lost during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/followers/gained_lost
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/followers/gained_lost?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Countries of Followers

The distribution of countries of Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/followers/countries
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/followers/countries?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Cities of Followers

The distribution of cities of Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/followers/cities
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/followers/cities?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Age of Followers

The distribution of Age of Followers

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/followers/age
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/followers/age?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Gender of Followers

The distribution of gender of Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/followers/gender
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/followers/gender?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Language of Followers

The distribution of languages of Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/followers/lang
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/followers/lang?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Followers Online

Shows the times of the day and the days of the week when your followers were most active on Instagram during the selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/followers/online
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/followers/online?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Best Time to Post

Shows the average engagement rate of posts published at specific times of day and days of the week.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/best_time_to_post
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/best_time_to_post?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Post Types

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/post_types
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/post_types?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Most Engaging Post Types

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/post_types/engaging
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/post_types/engaging?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Top Tags by Interactions

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/tags/top
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/tags/top?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Most Effective Tags

Top hashtags by the average number of interactions posts with these hashtags received.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/tags/effective
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/tags/effective?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Profile Views

The number of Profile Views during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/profile_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/profile_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Website Clicks

The number of clicks to links you've included in your business profile description.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/website_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/website_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Text Message Clicks

The number of clicks to the Text Message button in your profile.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/text_message_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/text_message_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Email Contacts

The number of clicks to the Email button in your profile.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/email_contacts
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/email_contacts?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Phone Call Clicks

The number of clicks to the Call button in your profile.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/phone_call_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/phone_call_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Get Directions Clicks

The number of clicks to the Get Directions button in your profile.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/get_directions_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/get_directions_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: Number of Posts

The total number of Posts during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/posts/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: Likes

The number of Likes by Post Type during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/posts/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: Comments

The number of Comments by Post Type during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/posts/comments
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/comments?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: Video Views

The number of times your video was viewed.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/posts/video_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/video_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: Impressions

The total number of times your posts were seen.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/posts/impressions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/impressions?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: Saves

The number of unique accounts that saved your post.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/posts/saves
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/saves?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: Post Eng Rate

Calculated as the sum of Likes and Comments divided by the number of Posts, divided by the number of Followers.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/posts/post_eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/post_eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: Profile Eng Rate

Calculated as the sum of all Likes and Comments divided by the number of Followers.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/posts/eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: Posts

A List of Posts.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int

    Page number.

  • order_by string

    Sorting parameter. This can be 'engagemen_rate', 'likes', 'comments', 'shares', 'video_views', 'impressions', 'reach' or 'saved'.

  • count int

    Number of posts per request. Max: 10,000.

GET /reports/{report_id}/instagram/posts
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=engagemen_rate&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Number of Stories

The total number of Stores published during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/stories/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Impressions

The total number of times your posts were seen.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/stories/impressions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/impressions?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Replies

The number of times people send messages through the Send Message option on your story.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/stories/replies
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/replies?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Exits

The number of times someone swiped from one of your stories to someone else's story, or returned to their Feed.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/stories/exits
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/exits?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Taps Back

The number of taps on your story to see the previous story.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/stories/taps_back
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/taps_back?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Taps Forward

The number of taps on your story to see the next story.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/stories/taps_forward
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/taps_forward?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Stories

Stories List

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int

    Page number.

  • order_by string

    Sorting parameter. This can be 'impressions', 'reach', 'taps_forward', 'taps_back', 'reach_rate', 'completion_rate', 'full_view_rate', 'follower_change', 'replies', 'exits' or 'created_time'.

  • count int

    Number of stories per request. Max: 10,000.

GET /reports/{report_id}/instagram/stories
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=impressions&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Caption Mentions

This is the number of mentions directly in post captions during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/posts/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/posts/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Tags on Posts

This is the number of tags on posts during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/tags/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/tags/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Comment Mentions

The number of mentions in comments during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/comments/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/comments/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Likes (Mentions)

This is the number of likes on posts, in which the account was directly mentioned in a caption during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/posts/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/posts/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Likes (Tags)

The number of likes on posts in which the account was tagged during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/tags/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/tags/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Unique Users (Mentions)

The number of unique Instagram users who mentioned your account username in their post caption during the selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/posts/users
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/posts/users?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Unique Users (Comments)

The number of unique Instagram users who mentioned your account username in a comment on a post during the selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/comments/users
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/comments/users?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Unique Users (Tags)

The number of unique Instagram users who tagged your account username to a photo or video that they shared on Instagram during the selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/tags/users
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/tags/users?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Mentions Posts

A List of Caption Mentions Posts.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • order_by string

    Sorting parameter. This can be 'likes', 'comments' or 'most_recent'.

  • media_type string

    Filtering parameter. This can be 'all', 'image', 'video' or 'carousel'.

  • count int

    Number of posts per request. Max: 10,000.

GET /reports/{report_id}/instagram/mentions/posts
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/posts?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=likes&media_type=all&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Comments

A List of Comment Mentions Posts.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • order_by string

    Sorting parameter. This can be 'likes', 'comments' or 'most_recent'.

  • media_type string

    Filtering parameter. This can be 'all', 'image', 'video' or 'carousel'.

  • count int

    Number of posts per request. Max: 10,000.

GET /reports/{report_id}/instagram/mentions/comments
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/comments?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=likes&media_type=all&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Posts with Tags

A List of Posts with Tags.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • order_by string

    Sorting parameter. This can be 'likes', 'comments' or 'most_recent'.

  • media_type string

    Filtering parameter. This can be 'all', 'image', 'video' or 'carousel'.

  • count int

    Number of posts per request. Max: 10,000.

GET /reports/{report_id}/instagram/mentions/tags
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/tags?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=likes&media_type=all&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Hashtags in Mentions

The top hashtags that were used with your account's mentions during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/posts/hashtags
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/posts/hashtags?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Mentions: Sentiment Rate

This is the average mention sentiment rate.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/mentions/posts/sentiment_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/mentions/posts/sentiment_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Hashtag: Total Posts

The number of Posts on the Hashtag during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/hashtag/posts/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/hashtag/posts/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Hashtag: Number of Posts

The total number of posts with your Hashtag published during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/hashtag/posts/change
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/hashtag/posts/change?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Hashtag: Likes

The total number of Likes by the post type during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/hashtag/posts/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/hashtag/posts/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Hashtag: Comments

The total number of Comments by the post type during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/hashtag/posts/comments
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/hashtag/posts/comments?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Hashtag: Sentiment Rate

The total number of Comments by the post type during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/hashtag/posts/sentiment_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/hashtag/posts/sentiment_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Hashtag: Posts

A List of Posts.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • count int

    Number of returned media. Max: 10,000.

GET /reports/{report_id}/instagram/hashtag/posts
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/hashtag/posts?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Hashtag: Associated Hashtags

Top Hashtags used with your Hashtag during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/hashtag/tags/similar
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/hashtag/tags/similar?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Hashtag: Number of Hashtags

The number of hashtags used with your Hashtag during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/instagram/hashtag/tags/distribution
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/hashtag/tags/distribution?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Followers

The number of profile's Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/followers/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/followers/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Follower Change

The absolute increase or decrease in Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/followers/change
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/followers/change?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Gained and Lost Followers

The number of Followers gained and lost during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/followers/gained_lost
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/followers/gained_lost?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Follows

The number of profile's Follows during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/followers/follows
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/followers/follows?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Gender of Followers

The distribution of gender of Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/followers/gender
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/followers/gender?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Countries of Followers

The distribution of countries of Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/followers/countries
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/followers/countries?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Cities of Followers

The distribution of cities of Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/followers/cities
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/followers/cities?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Language of Followers

The distribution of languages of Followers during a selected time range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/followers/language
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/followers/language?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Follower/Following Ratio

The distribution of followers by their Follower to Following ratio.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/followers/distribution_ratio
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/followers/distribution_ratio?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Number of Tweets

The total number of Tweets published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tweets/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Retweets

The total number of times your Tweets have been retweeted during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tweets/retweets
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/retweets?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Likes

The total number of times your Tweets have been liked during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tweets/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Tweet Type

This shows which Tweet types were used most often during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tweets/type
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/type?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Top Used Apps

This shows which apps the account used most often to publish the Tweets during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tweets/apps
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/apps?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Tweet Eng Rate

Calculated as the sum of all Retweets and Likes divided by number of Tweets, divided by number of Followers during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tweets/tweet_eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/tweet_eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Profile Eng Rate

Calculated as the sum of all Retweets and Likes divided by number of Followers during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tweets/eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Tweets

Tweets List

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • order_by string

    Sorting parameter. This can be 'engagement_rate', 'retweets', 'quotes', 'favorites', 'replies', 'impressions', 'url_link_clicks', 'user_profile_clicks', 'video_views', 'follower_change' or 'created_time'.

  • count int

    Number of tweets per request. Max: 10,000.

GET /reports/{report_id}/twitter/tweets
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=engagemen_rate&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Best Time to Post

Shows the average engagement rate of tweets published at specific times of the day and days of the week. The darkest red is the best time for you to post.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/best_time_to_post
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/best_time_to_post?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Top Tags

Top Tags used by the total number of Engagements received during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tags/top
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tags/top?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Most Effective Tags

Top Tags by the average number of Engagements received during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tags/effective
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tags/effective?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter: Number of Hashtags

This is the total amount of tweets grouped by the Number of Hashtags used, during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/tags/distribution
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tags/distribution?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Number of Tweets

The number of Tweets published using Hashtag during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/tweets/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/tweets/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Retweets

The number of times Tweets were retweeted during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/tweets/retweets
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/tweets/retweets?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Quotes

The number of times Tweets were quoted during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/tweets/quotes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/tweets/quotes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Replies

The number of times Tweets were replied to during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/tweets/replies
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/tweets/replies?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Video Views

The number of times Videos published during the selected date range were viewed.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/tweets/video_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/tweets/video_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Top Used Apps

The most used apps to publish Tweets during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/tweets/apps
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/tweets/apps?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Tweets

Tweets List

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • order_by string

    Sorting parameter. This can be 'engagement_rate', 'retweets', 'quotes', 'favorites', 'replies', 'video_views', 'follower_change' or 'created_time'.

  • count int

    Number of tweets per request. Max: 10,000.

GET /reports/{report_id}/twitter/hashtag/tweets
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/tweets?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=engagemen_rate&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Gender of Contributors

The distribution of gender of Contributors during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/contributors/gender
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/contributors/gender?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Countries of Contributors

The distribution of countries of Contributors during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/contributors/countries
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/contributors/countries?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Cities of Contributors

The distribution of cities of Contributors during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/contributors/cities
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/contributors/cities?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Language of Contributors

The distribution of languages of Contributors during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/contributors/lang
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/contributors/lang?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Associated Hashtags

The top Hashtags used with Hashtag during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/tags/similar
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/tags/similar?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Twitter Hashtag: Number of Hashtags

The number of hashtags used with Hashtag during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/twitter/hashtag/tags/distribution
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/hashtag/tags/distribution?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Number of Videos

The number of Videos published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/videos/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/videos/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Views

The number of times Videos published during the selected date range were viewed.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/videos/views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/videos/views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Likes

The number of Likes on Videos published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/videos/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/videos/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Comments

The number of Comments on Videos published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/videos/comments
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/videos/comments?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Shares

The number of Shares of Videos published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/videos/shares
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/videos/shares?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Video Eng Rate

The sum of all Likes, Comments and Shares divided by the number of Videos and by the number of Views on a given day during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/videos/eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/videos/eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Videos

Videos List

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • order_by string

    Sorting parameter. This can be 'engagement_rate', 'likes', 'comments', 'shares', 'views' or 'created_time'.

  • count int

    Number of videos per request. Max: 10,000.

GET /reports/{report_id}/tiktok/videos
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/videos?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=engagemen_rate&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Best Time to post

The average Engagement Rate of Videos published at specific times of the day and days of the week.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/best_time_to_post
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/best_time_to_post?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Top Hashtags

The top Hashtags used on Videos published during the selected date range, by the total number of Engagements they received.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/tags/top
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/tags/top?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Most Effective Hashtags

The top Hashtags used on Videos published during the selected date range, by the average Engagement Rate.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/tags/effective
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/tags/effective?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: Number of Hashtags

The number of Videos published during the selected date range, grouped by the number of Hashtags used on these Videos.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/tiktok/tags/distribution
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/tags/distribution?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Fans

The number of times Page was liked during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/fans/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/fans/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Fan Change

The absolute increase or decrease in Fans during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/fans/change
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/fans/change?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Gained and Lost Fans

The number of Gained and Lost Fans during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/fans/gained_lost
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/fans/gained_lost?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Gender of Fans

The gender ratio of Fans during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/fans/gender
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/fans/gender?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Age of Fans

The distribution of Age of Fans during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/fans/age
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/fans/age?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Countries of Fans

The countries of Fans during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/fans/countries
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/fans/countries?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Language of Fans

The canguage of Fans during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/fans/lang
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/fans/lang?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Fans Online

The times of the day and the days of the week when Fans were most active on Facebook during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/fans/online
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/fans/online?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Number of Posts

The number of Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Likes

The number of Likes on Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Comments

The number of Comments on Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/comments
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/comments?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Shares

The number of Shares on Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/shares
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/shares?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Video Views

The number of times Videos published during the selected date range were viewed.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/video_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/video_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Impressions

The number of times Posts published during the selected date range were seen.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/impressions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/impressions?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Reach

The number of times Posts were viewed by unique accounts during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/reach?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Post Eng Rate

The sum of all Likes, Comments and Shares divided by the number of Posts and by the number of Fans on a given day during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/post_eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/post_eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Page Eng Rate

The sum of all Likes, Comments and Shares divided by the number of Fans on a given day during the selected date range. The percent of Fans who interacted with any of Posts.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Reach Rate

The average Reach Rate of Posts posted on the given day during the selected date range. The percent of Fans who saw Posts.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/reach_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/reach_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Eng Rate by Reach

The sum of all Likes, Comments and Shares divided by Reach and by the number of Posts on a given day during the selected date range. Engagement Rate by Reach is the percent of unique accounts reached who interacted with Posts.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/posts/eng_rate_by_reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts/eng_rate_by_reach?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Posts

Posts List

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • order_by string

    Sorting parameter. This can be 'engagement_rate', 'likes', 'comments', 'shares', 'video_views', 'impressions', 'reach', 'eng_rate_by_reach', 'fan_change' or 'created_time'.

  • count int

    Number of posts per request. Max: 10,000.

GET /reports/{report_id}/facebook/page/posts
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/posts?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=engagemen_rate&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Best Time to post

The average Engagement Rate of Posts published at specific times of the day and days of the week during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/best_time_to_post
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/best_time_to_post?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Post Types

The distribution of Post Types during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/post_types
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/post_types?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Engaging Post Types

The distribution of Post Types by the number of Interactions during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/post_types/engaging
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/post_types/engaging?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Top Hashtags

The top Hashtags used on Posts by the total number of Interactions during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/tags/top
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/tags/top?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Most Effective Hashtags

The top Hashtags used on Posts by the average Engagement Rate during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/tags/effective
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/tags/effective?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Number of Hashtags

The number of Posts published during the selected date range grouped by the number of Hashtags used.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/tags/distribution
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/tags/distribution?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Number of Mentions

The number of Mentions published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/mentions/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/mentions/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Mentions: Likes

The number of Likes on Mentions during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/mentions/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/mentions/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Mentions: Shares

The number of Shares on Mentions during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/mentions/shares
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/mentions/shares?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Mentions: Contributors

The number of accounts who mentioned Page in their posts during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/mentions/contributors
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/mentions/contributors?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Mentions: Sentiment Rate

The average Mention Sentiment Rate during the selected date range. Sentiment Rate shows whether Mentions are positive, negative or neutral.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/mentions/sentiment
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/mentions/sentiment?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Language of Mentions

The languages of Mentions during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/mentions/lang
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/mentions/lang?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Hashtags in Mentions

The top Hashtags used in Mentions during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/facebook/page/mentions/tags
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/mentions/tags?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Mentions

Mentions List

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • order_by string

    Sorting parameter. This can be 'engagement_rate', 'likes', 'comments', 'shares', 'fan_count' or 'tagged_time'.

  • count int

    Number of posts per request. Max: 10,000.

GET /reports/{report_id}/facebook/page/mentions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/mentions?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=engagemen_rate&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Followers

The number of Followers during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/followers/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/followers/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Follower Change

The absolute increase or decrease in Follower during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/followers/change
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/followers/change?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Gained and Lost Followers

The number of Gained and Lost Followers during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/followers/gained_lost
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/followers/gained_lost?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Countries of Followers

The countries of Followers during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/followers/countries
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/followers/countries?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Industry of Followers

The distribution of Followers gained during the selected date range by the industry they work in.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/followers/industries
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/followers/industries?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Job Function of Followers

The distribution of Followers gained during the selected date range by their job function.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/followers/functions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/followers/functions?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Seniority of Followers

The distribution of Followers gained during the selected date range by their seniority level.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/followers/seniorities
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/followers/seniorities?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Association type of Followers

The association types of Followers during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/followers/association_types
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/followers/association_types?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Follower Company Sizes

The distribution of Followers gained during the selected date range by the staff count of the companies they work in.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/followers/staff_count_ranges
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/followers/staff_count_ranges?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Number of Posts

The number of Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Likes

The number of Likes on Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Comments

The number of Comments on Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/comments
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/comments?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Shares

The number of Shares on Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/shares
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/shares?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Clicks

The number of Clicks on Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Video Views

The number of times Videos published during the selected date range were viewed.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/video_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/video_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Impressions

The number of times Posts published during the selected date range were seen.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/impressions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/impressions?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Reach

The number of people who viewed Posts published during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/reach?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Post Eng Rate

The sum of all Likes, Comments, Shares and Clicks divided by the number of Posts and by the number of Followers on a given day during the selected date range. The percent of Followers who interacted with Posts.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/post_eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/post_eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Page Eng Rate

The sum of all Likes, Comments, Shares and Clicks divided by the number of Followers on a given day during the selected date range. The percent of Followers who interacted with any of Posts.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/posts/eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts/eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Posts

Posts List

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

  • skip int required

    Page number.

  • order_by string

    Sorting parameter. This can be 'engagement_rate', 'likes', 'comments', 'shares', 'clicks', 'video_views', 'impressions', 'follower_change' or 'created_time'.

  • count int

    Number of posts per request. Max: 10,000.

GET /reports/{report_id}/linkedin/page/posts
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/posts?date_from=2021-09-01&to_date=2021-10-01&unit=day&skip=0&order_by=engagemen_rate&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Best Time to post

The average Engagement Rate of Posts published at specific times of the day and days of the week during the selected date range. The darkest red is the best time to post.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/best_time_to_post
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/best_time_to_post?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Top Hashtags

The top Hashtags used on Posts by the total number of Interactions during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/tags/top
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/tags/top?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Most Effective Hashtags

The top Hashtags used on Posts published during the selected date range by the average Engagement Rate.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/tags/effective
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/tags/effective?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Number of Hashtags

The number of Posts published during the selected date range grouped by the number of Hashtags used.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/tags/distribution
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/tags/distribution?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Page Views

The number of times Page was viewed during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/page_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/page_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Page Reach

The number of people who viewed any content from Page or about Page during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/page_reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/page_reach?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Products Views

The number of times the Products tab was viewed during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/products_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/products_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Insgihts Views

The number of times the Insights tab was viewed during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/insgihts_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/insgihts_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: About Views

The number of times the About tab was viewed during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/about_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/about_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Jobs Views

The number of times the Jobs tab was viewed during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/jobs_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/jobs_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: People Views

The number of times the People tab was viewed during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/people_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/people_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Overview Views

The number of times the Overview tab was viewed during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/overview_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/overview_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Live At Views

The number of times the Live At tab was viewed during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/live_at_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/live_at_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Careers Views

The number of times the Careers tab was viewed during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/careers_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/careers_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Promo Link Clicks

The number of clicks on Careers Page Promo Links during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/promo_link_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/promo_link_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Banner Promo Clicks

The number of clicks on Careers Page Banner Promos during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/promo_banner_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/promo_banner_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Jobs Clicks

The number of clicks on Careers Page Jobs during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/jobs_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/jobs_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

LinkedIn Page: Employees Clicks

The number of clicks on Careers Page Employees during the selected date range.

URL Parameters

  • report_id string required

    The ID of the report.

Query Parameters

  • date_from string required

    The beginning of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • to_date string required

    The end of the date range to get data for in yyyy-mm-dd format. This date is inclusive.

  • unit string required

    This can be 'day', 'week', or 'month'. It determines the level of granularity of the data you get back.

GET /reports/{report_id}/linkedin/page/employees_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/employees_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"