Skip to main content

Channel Estimator

Deprecation Alert!

For the future-forward version of this endpoint, please see the Channel Estimate page.

This endpoint is approaching End of Life scheduled for 2025-12-21, after which this endpoint will be completely unsupported and unavailable to incoming requests.

warning

The DMT API is current in pre-alpha. This means you should not rely on its availability, and that it may change without warning, although we will certainly make a best effort to contact you in advance.

If you wish to get early access, sign up using this form (I promise we look at it!)

The /estimator endpoint provided by DMT provides a viewership projection of hypothetical video for a given YouTube, tiktok, Instagram, or Twitch channel, either by channelId or channelName - either one is optional, but at least one must be used in your request for a successful response.

tip

This Channel Estimate service is an exclusive service provided by DMT and the underlying calculations are the result of a need for something similar for the last 10 years of 'influencer marketing.'

While these projections have been used with real clients and in production use-cases, we recommend thinking of them as a way to benchmark a channel's performance and inform your pricing decisions, they are not a guarantee.

Request example​

cURL Channel Estimate
curl -H 'Authorization: Bearer {{YOUR_API_KEY}}' \
-X GET \
'https://stg.directmessage.tech/api/v0/analytics/creators/estimate?channelName=@JohnCooganPlus&channelType=youtube'

Endpoint parameters​

You will notice there are two parameters in the request to the endpoint:

  • channelName - this is the @username of the channel you are requesting data for, in this case "@JohnCooganPlus" in the exmaple
  • channelType - the social media platform that the channel you are requesting data for publishes on. In this case "youtube"

There is also a third parameter

  • channelId - the channel ID of the channel in question, this would be a large integer number for tiktok and twitch channels, and a 24 character text ID like UChQl2YkLt3dj-KDyGUBzcHw for YouTube channels
warning

Use either the channelId OR the channelName query parameter, but one of those parameters is required for a successful response.

Response example​

200 Status​

Channel Estimator response
{
	"data": {
		"channel": {
			"id": "UC53aFFx91VWnxLplgZBuXOQ",
			"type": "youtube"
		},
		"projection": {
			"views": 7099,
			"type": "default"
		}
	}
}
info

The type property nested in the projection response indicates if a broader (or "expanded") slice of the channel's dataset was used to generate this view performance projection.

This is a sample successful request response payload. Note the data object in which all other objects will be nested in as standard formatting with any DMT API endpoint.

422 Error Status​

The 422 Unprocessable Content error status code is expected to return if you attempted to submit an invalid body or query param request to the Estimator API endpoint.

Channel Estimate 422 Error response
{
	"error": {
		"message": "Invalid user input.\n
		Please reference docs for how to submit requests to the API:\n
		https://docs.directmessage.tech/api/api-estimator#422-error-status",
		"statusCode": 422
		}
}