Realtime Tracking API
POST - Add Creator For Tracking
This API serves the purpose of generating a tracking link specifically designed for the selected influencer, enabling precise monitoring and analytics.
curl --location 'https://dashboard.ylytic.com/ylytic/api/v1/rt_tracking/creators' \
--header 'Authorization: Bearer {{auth_token}}' \
--data '{
"connector" : "instagram",
"handle" : "rcvjinsta",
"cron expression": "0 1 * * *",
"stories_cron_expression": "0 15 * * *",
"stories_tracking_expiry_at":"2023-12-15 12:10:01.0",
"tracking_expiry_at":"2023-12-10 12:12:1.0"
}'
POST PARAMS
connector
The social connector flow that needs to be triggered for the creator. currently supported values are Youtube and Instagram.
handle
A handle is the username of a particular creator on Instagram or YouTube.
cron_expression
A cron expression is a string format representing a schedule for recurring tasks in a cron job, specifying the timing and frequency of task execution.
stories_cron_expression
is a string representing a schedule in cron format for recurring tasks related to tracking and managing stories on social media platforms.
stories_tracking_expiry_at
refers to the timestamp indicating the expiration time or date for tracking events related to stories on social media platforms.
tracking_expiry_at
refers to the timestamp denoting the expiration time or date for a tracking event or action in a system or application.
PAYLOAD
{
"connector" : "instagram",
"handle" : "rcvjinsta",
"cron expression": "0 1 * * *",
"stories_cron_expression": "0 15 * * *",
"stories_tracking_expiry_at":"2023-12-15 12:10:01.0",
"tracking_expiry_at":"2023-12-10 12:12:1.0"
}
OUTPUT(JSON)
{
"connector": "instagram",
"handle": "rcvjinsta",
"tracking": true,
"cron_expression": "0 1 * * *",
"next_tracking_at": "2023-12-23 01:00:00",
"tracking_expiry_at": "2023-12-10 12:12:01",
"created_at": "2023-12-22 10:10:03.814000",
"stories_tracking": true,
"stories_cron_expression": "0 15 * * *",
"next_stories_tracking_at": "2023-12-22 15:00:00",
"stories_tracking_expiry_at": "2023-12-15 12:10:01",
"event_insights": {
"total": 0,
"webhooks_success_total": 0,
"this_month": 0,
"webhooks_success_this_month": 0,
"today": 0,
"webhooks_success_today": 0,
"events_datewise_this_month": [],
"events_creatorwise_this_month": []
}
}
GET - Get Creator
The "Get Creator" API retrieves information about a specific creator from the Ylytic platform, offering insights into audience demographics and engagement metrics.
curl --location 'https://dashboard.ylytic.com/ylytic//api/v1/rt_tracking/creators/rcvjinsta' \
--header 'Authorization: Bearer {{auth_token}}'
OUTPUT(JSON)
{
"connector": "instagram",
"handle": "rcvjinsta",
"tracking": true,
"cron_expression": "0 1 * * *",
"next_tracking_at": "2023-12-23 01:00:00",
"tracking_expiry_at": "2023-12-10 12:12:01",
"created_at": "2023-12-22 10:10:03.814000",
"stories_tracking": true,
"stories_cron_expression": "0 15 * * *",
"next_stories_tracking_at": "2023-12-22 15:00:00",
"stories_tracking_expiry_at": "2023-12-15 12:10:01",
"event_insights": {
"total": 0,
"webhooks_success_total": 0,
"this_month": 0,
"webhooks_success_this_month": 0,
"today": 0,
"webhooks_success_today": 0,
"events_datewise_this_month": [],
"events_creatorwise_this_month": []
}
}
PUT - Update Creator Tracking
The "PUT - Update Creator Tracking" API endpoint facilitates the updating of tracking information for a specific creator in the system.
curl --location --request PUT 'https://dashboard.ylytic.com/ylytic/api/v1/rt_tracking/creators/rcvjinsta' \
--header 'Authorization: Bearer {{auth_token}} \
--data '{
"tracking" : "False",
"stories_tracking" : "False",
"cron_expression":"0 1 * * *",
"stories_cron_expression":"0 1 * * *",
"stories_tracking_expiry_at":"2023-12-15 12:10:01.0",
"tracking_expiry_at":"2023-12-10 12:12:1.0"
}'
POST PARAMS
tracking
To verify if tracking is currently active, it returns a boolean value.
story_tracking
To verify if story tracking is currently active, it returns a boolean value.
PAYLOAD
{
"tracking" : "False",
"stories_tracking" : "False",
"cron_expression":"0 1 * * *",
"stories_cron_expression":"0 1 * * *",
"stories_tracking_expiry_at":"2023-12-15 12:10:01.0",
"tracking_expiry_at":"2023-12-10 12:12:1.0"
}
OUTPUT (JSON)
{
"connector": "instagram",
"handle": "rcvjinsta",
"tracking": false,
"cron_expression": "0 1 * * *",
"next_tracking_at": "2023-12-23 01:00:00",
"tracking_expiry_at": "2023-12-10 12:12:01",
"created_at": "2023-12-22 10:10:03.814000",
"stories_tracking": false,
"stories_cron_expression": "0 1 * * *",
"next_stories_tracking_at": "2023-12-22 15:00:00",
"stories_tracking_expiry_at": "2023-12-15 12:10:01",
"event_insights": {
"total": 0,
"webhooks_success_total": 0,
"this_month": 0,
"webhooks_success_this_month": 0,
"today": 0,
"webhooks_success_today": 0,
"events_datewise_this_month": [],
"events_creatorwise_this_month": []
}
}
POST - Add Post For Tracking
The "POST - Add Post for Tracking" API allows for the inclusion and tracking of posts, providing a method to monitor and analyze specific content within the system.
curl --location 'https://dashboard.ylytic.com/ylytic/api/v1/rt_tracking/posts' \
--header 'Authorization: Bearer {{auth_token}}' \
--data '{
"connector" : "instagram",
"shortcode" : "C1JjTC-STpl",
"handle":"brut.india",
"cron_expression":"0/5 * * * *",
"tracking_expiry_at": "2024-10-23 12:23:12.12"
}'
POST PARAMS
shortcode
A ShortCode is the Instagram URL of the profile of the creator, serving as a concise identifier for their account.
PAYLOAD
{
"connector" : "instagram",
"shortcode" : "C1JjTC-STpl",
"handle":"brut.india",
"cron_expression":"0/5 * * * *",
"tracking_expiry_at": "2024-10-23 12:23:12.12"
}
OUTPUT (JSON)
{
"connector": "instagram",
"shortcode": "C1JjTC-STpl",
"tracking": true,
"cron_expression": "0/5 * * * *",
"next_tracking_at": "2023-12-22 10:22:23.774000",
"tracking_expiry_at": "2024-10-23 12:23:12.120000",
"created_at": "2023-12-22 10:22:23.774000",
"event_insights": {
"total": 0,
"webhooks_success_total": 0,
"this_month": 0,
"webhooks_success_this_month": 0,
"today": 0,
"webhooks_success_today": 0,
"events_datewise_this_month": [],
"events_creatorwise_posts_this_month": []
}
}
GET - Get Post
The "GET - Get Post" API retrieves information about a specific post, allowing users to access details and analytics associated with the identified content.
curl --location 'https://dashboard.ylytic.com/ylytic/api/v1/rt_tracking/posts/C1JjTC-STpl' \
--header 'Authorization: Bearer {{auth_token}}'
OUTPUT (JSON)
{
"connector": "instagram",
"handle": "rcvjinsta",
"tracking": true,
"cron_expression": "0 1 * * *",
"next_tracking_at": "2023-12-23 01:00:00",
"tracking_expiry_at": "2023-12-10 12:12:01",
"created_at": "2023-12-22 10:10:03.814000",
"stories_tracking": true,
"stories_cron_expression": "0 15 * * *",
"next_stories_tracking_at": "2023-12-22 15:00:00",
"stories_tracking_expiry_at": "2023-12-15 12:10:01",
"event_insights": {
"total": 0,
"webhooks_success_total": 0,
"this_month": 0,
"webhooks_success_this_month": 0,
"today": 0,
"webhooks_success_today": 0,
"events_datewise_this_month": [],
"events_creatorwise_this_month": []
}
}
PUT - Update Post Tracking
The "PUT - Update Post Tracking" API enables the modification and updating of tracking information for a specific post in the system.
curl --location --request PUT 'https://dashboard.ylytic.com/ylytic/api/v1/rt_tracking/posts/C1JjTC-STpl' \
--header 'Authorization: Bearer {{auth_token}}' \
--data '{
"connector" : "instagram",
"tracking": "False",
"cron_expression" : "*/3 * * * *",
"tracking_expiry_at": "2024-10-23 12:23:12.12"
}'
PAYLOAD
{
"connector" : "instagram",
"tracking": "False",
"cron_expression" : "*/3 * * * *",
"tracking_expiry_at": "2024-10-23 12:23:12.12"
}
OUTPUT(JSON)
{
"connector": "instagram",
"shortcode": "C1JjTC-STpl",
"tracking": false,
"cron_expression": "*/3 * * * *",
"next_tracking_at": "2023-12-22 10:30:00",
"tracking_expiry_at": "2024-10-23 12:23:12.120000",
"created_at": "2023-12-22 10:22:23.774000",
"event_insights": {
"total": 1,
"webhooks_success_total": 0,
"this_month": 1,
"webhooks_success_this_month": 0,
"today": 1,
"webhooks_success_today": 0,
"events_datewise_this_month": [
{
"2023-12-22": 1,
"webhook_success": 0
}
],
"events_creatorwise_posts_this_month": [
{
"brut.india": 1,
"webhook_success": 0
}
]
}
}
GET – Tracking Insights
The "GET – Tracking Insights" API provides insights and analytics related to tracking activities, offering valuable information about monitored events and data within the system.
curl --location 'https://dashboard.ylytic.com/ylytic/api/v1/rt_tracking/insights' \
--header 'Authorization: Bearer {{auth_token}}'
Last updated