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

ATTRIBUTESDESCRIPTION

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

ATTRIBUTESDESCRIPTION

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

ATTRIBUTESDESCRIPTION

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