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, X/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.

Rate Limits

The Minter.io API has hourly rate limits. It is recommended to restrict your requests to 5,000 per hour per API token. If you exceed the rate limit by making too many requests, you will receive a response code 429.

Minter.io reserves the right to modify rate limits in the future, without prior notification, to ensure the health and stability of the Minter.io API.

Rate limit response
429 Too Many Requests

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: 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}/instagram/follows/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/follows/count?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

The number of Interactions on Posts 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}/instagram/best_time
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/best_time?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Best Time to Post, Eng

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 Visits

The number of times the Profile was visited 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/profile_visits
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/profile_visits?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Impressions

The number of times Posts, Stories and Promotions were 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}/instagram/impressions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/impressions?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Reach

The number of unique accounts who viewed Posts, Stories and Ads 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/reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/reach?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Reach Distribution

The percentage of followers and non-followers that viewed your Posts, Stories and Ads during the selected date range. We can show only up to 30 days of Reach Distribution due to the Instagram API limitations.

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/reach/distribution
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/reach/distribution?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Accounts Engaged

The number of unique accounts who interacted with your Posts, Stories and Ads 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/accounts_engaged
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/accounts_engaged?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Engagement Rate

The percentage of followers who interacted with your Posts, Stories or Ads 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/eng_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/eng_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Shares

The number of times Posts, Stories and Ads were shared 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/shares
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/shares?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Website Taps

The number of Taps on the link to the website in the bio 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/website_taps
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/website_taps?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Text Button Taps

The number of Taps on the Text button in the bio 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/text_button_taps
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/text_button_taps?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Email Button Taps

The number of Taps on the Email button in the bio 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/email_button_taps
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/email_button_taps?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Call Button Taps

The number of Taps on the phone number or Call Now button in the bio 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/call_button_taps
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/call_button_taps?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram: Business Address Taps

The number of Taps on the Business Address link in the bio 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/business_address_taps
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/business_address_taps?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: 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: Shares

The number of times Posts were shared 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/shares
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/shares?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: Profile Visits

The number of times your profile was visited from your 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/posts/profile_visits
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/profile_visits?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Posts: 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}/instagram/posts/reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/reach?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: Reach Rate

The average Reach Rate of Posts posted on the given day during the selected date range. The percentage of Followers 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}/instagram/posts/reach_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/posts/reach_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', 'profile_visits' 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: Reach

The number of times Stories 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}/instagram/stories/reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/reach?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: Shares

The number of times Stories were shared 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/stories/shares
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/shares?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: 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: Profile Visits

The number of times your profile was visited from your Stories 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/stories/profile_visits
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/profile_visits?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Reach Rate

The average Reach Rate of Stories posted on the given day during the selected date range. The percentage of Followers who saw Stories.

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/reach_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/reach_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Completion Rate

The average Completion Rate of Stories posted on the given day during the selected date range. Completion Rate is the percentage of Impressions without Exits.

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/completion_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/completion_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Full View Rate

The average Full View Rate of Stories posted on the given day during the selected date range. Full View Rate is the percentage of Impressions without Exits or Taps Forwards.

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/full_view_rate
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/full_view_rate?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Stories: Best Time to post

The average Reach Rate of Stories published at specific times of the day and specific days of the week. The darkest red area is the best time to post Stories for maximum reach.

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/best_time_to_post
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/stories/best_time_to_post?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', 'replies', 'shares', 'taps_back', 'taps_forward', 'exits', 'profile_visits', 'reach_rate', 'completion_rate', 'full_view_rate', 'follower_change' 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 Ads: Number of Ads

The number of Ads posted 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/ads/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ad 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/ads/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ad 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/ads/comments
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/comments?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ad Clicks

The number of times Ads were clicked 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/ads/clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ad Video Views

The number of times Ad Videos were 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}/instagram/ads/video_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/video_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ad Impressions

The number of times Ads were seen 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/ads/impressions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/impressions?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ad Reach

The number of times Ads 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}/instagram/ads/reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/reach?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ad Shares

The number of times Ads were shared 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/ads/shares
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/shares?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ad Saves

The number of times Ads were saved 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/ads/saves
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/saves?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Engagement Rate by Reach

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

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/ads/eng_rate_by_reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/eng_rate_by_reach?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ad Spend

The amount of money spent on Ads 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/ads/spend
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads/spend?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Instagram Ads: Ads

A List of Ads.

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', 'clicks', 'impressions', 'reach', 'saves', 'video_views', 'spend', 'eng_rate_by_reach' or 'created_time'.

  • media_type string

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

  • count int

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

GET /reports/{report_id}/instagram/ads
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/instagram/ads?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: 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"

X/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"

X/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"

X/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"

X/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/follows/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/follows/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/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"

X/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"

X/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"

X/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"

X/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"

X/Twitter: Number of Posts

The total 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}/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"

X/Twitter: Views

The number of times Posts were seen 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/impressions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/impressions?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Reposts

The total number of times your Posts have been reposted 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"

X/Twitter: Quotes

The number of times Posts 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/tweets/quotes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/quotes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Likes

The total number of times your Posts 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"

X/Twitter: Replies

The number of times Posts 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/tweets/replies
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/replies?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Link Clicks

The number of times Links in Posts were clicked 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/link_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/link_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Profile Clicks

The number of times Profile was visited from 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}/twitter/tweets/profile_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/profile_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: 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/tweets/video_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/tweets/video_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Post Type

This shows which Post 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"

X/Twitter: Top Used Apps

This shows which apps the account used most often to publish the 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}/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"

X/Twitter: Post Eng Rate

Calculated as the sum of all Reposts and Likes divided by number of Posts, 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"

X/Twitter: Profile Eng Rate

Calculated as the sum of all Reposts 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"

X/Twitter: 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', 'retweets', 'quotes', 'likes', 'replies', 'impressions', 'url_link_clicks', 'user_profile_clicks', 'video_views', 'follower_change' or 'created_time'.

  • media_type string

    Filtering parameter. This can be 'all', 'tweets' or 'replies'.

  • count int

    Number of Posts 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&media_type=all&count=24 \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Best Time to Post

Shows the average engagement rate of Posts 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"

X/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"

X/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"

X/Twitter: Number of Hashtags

This is the total amount of Posts 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"

X/Twitter: 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}/twitter/mentions/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/mentions/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Likes (Mentions)

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}/twitter/mentions/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/mentions/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Reposts (Mentions)

The number of Reposts 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}/twitter/mentions/retweets
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/mentions/retweets?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Unique Users (Mentions)

The number of accounts who mentioned Profile 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}/twitter/mentions/users
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/mentions/users?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: 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}/twitter/mentions/hashtags
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/mentions/hashtags?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Mention Sentiment Rate

The average Mention Sentiment 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}/twitter/mentions/sentiment
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/mentions/sentiment?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Language of Mentions

The language 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}/twitter/mentions/lang
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/mentions/lang?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: 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 'retweets', 'quotes', 'likes', 'followers' or 'created_time'.

  • count int

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

GET /reports/{report_id}/twitter/mentions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/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"

X/Twitter: Number of Replies

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}/twitter/replies/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/replies/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Likes (Replies)

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}/twitter/replies/likes
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/replies/likes?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Reposts (Replies)

The number of Reposts 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}/twitter/replies/retweets
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/replies/retweets?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Unique Users (Replies)

The number of unique accounts who replied to 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}/twitter/replies/users
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/replies/users?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Hashtags in Replies

The top Hashtags used in Replies 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/replies/hashtags
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/replies/hashtags?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Reply Sentiment Rate

The average Reply Sentiment 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}/twitter/replies/sentiment
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/replies/sentiment?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Language of Replies

The language of Replies 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/replies/lang
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/replies/lang?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

X/Twitter: Replies

Replies 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 'retweets', 'quotes', 'likes', 'followers' or 'created_time'.

  • count int

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

GET /reports/{report_id}/twitter/replies
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/twitter/replies?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"

X/Twitter Hashtag: Number of Posts

The number of Posts 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"

X/Twitter Hashtag: Reposts

The number of times Posts were reposted 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"

X/Twitter Hashtag: Quotes

The number of times Posts 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"

X/Twitter Hashtag: Replies

The number of times Posts 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"

X/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"

X/Twitter Hashtag: Top Used Apps

The most used apps to publish 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}/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"

X/Twitter Hashtag: 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', 'retweets', 'quotes', 'likes', 'replies', 'video_views', 'follower_change' or 'created_time'.

  • count int

    Number of Posts 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"

X/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"

X/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"

X/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"

X/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"

X/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"

X/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: 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}/tiktok/followers/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/followers/count?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: 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}/tiktok/followers/change
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/followers/change?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

TikTok: 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}/tiktok/follows/count
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/tiktok/follows/count?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', 'follower_change' 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: Gender of Audience

The gender distribution of unique accounts who viewed your Page or content 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/audience/gender
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/audience/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: Age of Audience

The distribution of age of unique accounts who viewed your Page or content 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/audiece/age
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/audiece/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: Cities of Fans

The cities 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/cities
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/fans/cities?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', 'link_clicks', 'video_views', 'impressions', 'reach', 'eng_rate_by_reach', 'fan_change' or 'created_time'.

  • media_type string

    Filtering parameter. This can be 'all', 'text', 'link', 'photo', 'video', 'reel', 'album' or 'note'.

  • 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&media_type=all&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: 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}/facebook/page/page_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/page_views?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Top Referrals

The top referrering external domains sending traffic to 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}/facebook/page/page_views_referrals
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/page_views_referrals?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Impressions

The number of times any content from Page or about Page was viewed during the selected date range. This includes Posts, Stories, Check-ins, Ads, Social Information from people who interacted with Page.

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/page_impressions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/page_impressions?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Reach

The number of people who viewed any content from Page or about Page during the selected date range. This includes Posts, Stories, Check-ins, Ads, Social Information from people who interacted with Page.

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/page_reach
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/page_reach?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Link Clicks

The number of Clicks on 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}/facebook/page/page_link_clicks
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/page_link_clicks?date_from=2021-09-01&to_date=2021-10-01&unit=day \
  -H "Authorization: Bearer ACCESS_TOKEN"

Facebook Page: Page Actions

The number of Clicks on Page's contact info and call-to-action button 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/page_total_actions
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/facebook/page/page_total_actions?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', 'fans' 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: 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: 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: Insights 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/insights_views
curl https://api.minter.io/v1.0/reports/13fcaded87e0642b96d87225/linkedin/page/insights_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"