Data Refresh API

POST – Create Data Refresh Request

This API is used for refreshing the existing data of the creator.

curl --location 'https://dashboard.ylytic.com/ylytic/api/v1/data_refresh/requests' \
--header 'Authorization: Bearer {{auth_header}}' \
--data '{
    "request_type":"instagram",
    "handle":"thetatvaindia"
}'

POST PARAM

ATTRIBUTESDESCRIPTION

request_type

request_type is the name of the social media platform, such as Instagram or YouTube.

handle

the handle name of the creator.

PAYLOAD

{
    "request_type":"instagram",
    "handle":"thetatvaindia"
}

OUTPUT (JSON)

{
    "request_id": "65b87c8576c9b42b3a285805",
    "request": {
        "request_type": "instagram",
        "handle": "thetatvaindia"
    },
    "response": null,
    "status": {
        "code": 201,
        "message": "pending",
        "request_at": "Tue, 30 Jan 2024 04:35:17 GMT",
        "response_at": null
    }
}

GET – Get Data Refresh Request

curl --location 'https://insights.ylytic.com/ylytic/api/v1/insights/creators/65ba622f76c9b42b3a28f1af?key=c047e317-a84d-4ea5-9463-7c390e1b33de' \
--header 'Authorization: Bearer {{auth_token}}'

OUTPUT (JSON)


    "profile_overview": {
        "handle": "a_poetic_storyteller",
        "followers_count": 1254,
        "post_count": 90,
        "following_count": 1235,
        "ig_user_id": "44746813468",
        "content_per_week": 0.87,
        "engagement": 47.94,
        "influencer_tier": "Nano",
        "last_processed_at": "31/01/2024"
    },
    "profile_details": {
        "biography": "कलाकार\nI am approachable not accessible !",
        "mobile": null,
        "gender": "male",
        "age_group": "25-34",
        "category": "Sports",
        "interests": [],
        "location": "Pune",
        "country": "India",
        "mentions": [
            "@brahmighadigaonkar",
            "@_sani_trakari_",
            "@shubham_kakade_1",
            "@kaus_tube",
            "@bhaveshpatange_97",
            "@bhaktigoswamii",
            "@abhishek_amate",
            "@i_am_swatiiii_",
            "@a_poetic_storyteller",
            "@its_me_sakshiiii",
            "@seemanikam_",
            "@virat.kohli",
            "@fakira_1797",
            "@maharashtracricketofficial"
        ],
        "hashtags": [
            "#gadhihatya",
            "#kingkohli",
            "#bappamorya",
            "#rammandir",
            "#rammandirayodhya",
            "#viratcentury",
            "#womenscricketteam",
            "#trend",
            "#viratkohli"
        ],
        "brand_mentions": [
            "a_poetic_storyteller"
        ],
        "mentions_details": [
            {
                "name": "Virat Kohli",
                "username": "virat.kohli",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/3d7637b7-997e-45e1-8447-bfc10713d3d6.jpg",
                "handle_link": "https://instagram.com/virat.kohli"
            },
            {
                "name": "",
                "username": "seemanikam_",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/578e9256-7e4b-425b-ab42-1552f7e9b006.jpg",
                "handle_link": "https://instagram.com/seemanikam_"
            },
            {
                "name": "Ratnadeep Mahadev Shinde",
                "username": "a_poetic_storyteller",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/8df56d1e-6b64-4c94-bcab-d69d8d782145.jpg",
                "handle_link": "https://instagram.com/a_poetic_storyteller"
            }
        ],
        "brand_mentions_details": [
            {
                "name": "Ratnadeep Mahadev Shinde",
                "username": "a_poetic_storyteller",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/8df56d1e-6b64-4c94-bcab-d69d8d782145.jpg",
                "handle_link": "https://instagram.com/a_poetic_storyteller"
            }
        ],
        "look_alike_creators": [
            {
                "name": "Vivek Soni",
                "username": "vivek_the_runner",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/89db5a79-e53e-407e-aa8a-5c5a8a4808b7.jpg",
                "handle_link": "https://instagram.com/vivek_the_runner"
            },
            {
                "name": "Vimarsh Patel",
                "username": "vimarsh81",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/b5461011-2185-4678-9103-363ea214ac2a.jpg",
                "handle_link": "https://instagram.com/vimarsh81"
            },
            {
                "name": "Vanshika | Fitness Coach",
                "username": "thefitlife7",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/e92d2720-dee8-45eb-8816-0fc52495159c.jpg",
                "handle_link": "https://instagram.com/thefitlife7"
            },
            {
                "name": "SHINE ON EVENTS BY PRIYANKA JAJOO",
                "username": "shineonevents_priyankajajoo",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/654ff6db-2a9e-4df1-84c0-b272a3e53301.jpg",
                "handle_link": "https://instagram.com/shineonevents_priyankajajoo"
            },
            {
                "name": "Ravindar Singh",
                "username": "ravindarsinghbb",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/c307b601-8a52-4958-a4e2-c26f9862547b.jpg",
                "handle_link": "https://instagram.com/ravindarsinghbb"
            },
            {
                "name": "Akshay Punjabi",
                "username": "pseudogoanpunjabi",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/471cdb69-ea37-4400-81ae-460347021806.jpg",
                "handle_link": "https://instagram.com/pseudogoanpunjabi"
            },
            {
                "name": "Ankit Agrawal",
                "username": "fitankit09",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/97228812-b454-4ad1-9332-040f63c61352.jpg",
                "handle_link": "https://instagram.com/fitankit09"
            },
            {
                "name": "Anoop Bangera",
                "username": "anoopbangera",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/97882f01-4e6b-473a-a453-395e5be682c7.jpg",
                "handle_link": "https://instagram.com/anoopbangera"
            },
            {
                "name": "Amandeep Singh Dhaliwal",
                "username": "amandhaliwal0089",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/6e613141-0273-46b7-b9d3-80d4937ec506.jpg",
                "handle_link": "https://instagram.com/amandhaliwal0089"
            },
            {
                "name": "Akshat Sharma",
                "username": "akki_pandit.145",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/a4698a32-9c74-4ca2-88e8-6e53107ee7be.jpg",
                "handle_link": "https://instagram.com/akki_pandit.145"
            }
        ],
        "ig_user_id": "44746813468",
        "ig_category": "Writer",
        "quality": {
            "profile_quality_score": 92,
            "profile_quality_rating": 4,
            "engagement_rate": 4,
            "effective_followers": 4,
            "consistency": 3,
            "authentic_audience": 0
        },
        "languages": [],
        "email": null,
        "handle": "a_poetic_storyteller",
        "handle_link": "https://instagram.com/a_poetic_storyteller",
        "full_name": "Ratnadeep Mahadev Shinde",
        "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/8df56d1e-6b64-4c94-bcab-d69d8d782145.jpg",
        "external_link": [],
        "last_processed_at": "31/01/2024"
    },
    "get_reach_and_engagement_details": {
        "non_video_engagement": 17.54,
        "non_video_average_comments": 6,
        "non_video_reach": 2089,
        "non_video_average_views": 2199,
        "non_video_average_likes": 213,
        "median_views": 4315,
        "median_unique_viewers": 4099,
        "effective_follower_rate": 326.9,
        "median_comments": 11,
        "median_likes": 249,
        "popular_post_type": "Reels",
        "estimated_story_reach": 60,
        "estimted_story_views": 64,
        "ig_user_id": "44746813468",
        "paid_post_average_views": null,
        "paid_post_average_comments": null,
        "paid_post_average_likes": null,
        "paid_post_engagement": null,
        "handle": "a_poetic_storyteller",
        "average_views": 19052,
        "average_unique_viewers": 18099,
        "overall_engagement": 47.94,
        "average_comments": 14,
        "average_likes": 586,
        "video_engagement": 58.08,
        "video_average_comments": 17,
        "video_average_likes": 710,
        "last_processed_at": "31/01/2024"
    },
    "get_posts": {
        "video_posts": [
            {
                "shortcode": "C2uWan_v0ru",
                "hashtags": [
                    "##gandhi",
                    "#gandhiquotes",
                    "#gandhiji",
                   ],
                "caption": "राष्ट्र पित्यास विनम्र अभिवादन ! \n\nकाळजी करू नका तुमचा विचार काही लोकांमध्ये का होईना पण जिवंत आहे ! \nआणि ज्याना पटवून घ्यायचा नाही त्यांना काळानुसार तो घ्यावा लागेल याची शाश्वती मला आहे ! \n\n##gandhi  #gandhiquotes #gandhiji #gandhijithoughts #gandhiassassination #gadhihatya #deathanniversary #punyatithi #poems #kavita #reelsinstagram #reels #showsomelove",
                "comments_count": 0,
                "likes_count": 44,
                "er": 3.51,
                "views": 2517,
                "posted_at": 1706617323,
                "posted_date": "Tue, 30 Jan 2024 12:22:03 GMT",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/C2uWan_v0ru.jpg",
                "sponsored": false,
                "external_links": [],
                "video": true,
                "post_type": "REEL",
                "mentions": [],
                "location_name": ""
            },
            {
                "shortcode": "C2i51IIITd4",
                "hashtags": [
                    "#republicday",
                    "#Indianrepublicday",
                    "#26january",
                    "#respecttheindianflag",
                    "#tiranga",
                    ]                ],
                "caption": "राष्ट्रध्वजाचा सन्मान म्हणजे देशाचा सन्मान ! \n\nText By: 💁‍♂️\nCalligraphy: @bhaktigoswamii \nThank you: @seemanikam_ @shubham_kakade_1 @i_am_swatiiii_  @abhishek_amate @its_me_sakshiiii \n\n#republicday #Indianrepublicday #26january #respecttheindianflag #tiranga #tiranga🇮🇳 #tiranga #marathiquotes #fcroadpune #seriouscontent #trendingreels #trend #nationallove #reelsindia #indian #indianbride",
                "comments_count": 29,
                "likes_count": 3050,
                "er": 245.53,
                "views": 57753,
                "posted_at": 1706233495,
                "posted_date": "Fri, 26 Jan 2024 01:44:55 GMT",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/C2i51IIITd4.jpg",
                "sponsored": false,
                "external_links": [],
                "video": true,
                "post_type": "REEL",
                "mentions": [
                    "@bhaktigoswamii",
                    "@seemanikam_",
                    "@shubham_kakade_1",
                    "@i_am_swatiiii_",
                    "@abhishek_amate",
                    "@its_me_sakshiiii"
                ],
                "location_name": "Pune, Maharashtra"
            },
            {
                "shortcode": "C2XLaGHon4r",
                "hashtags": [
                    "#rammandirayodhya",
                    "#rammandir",
                    "#shriram",
                    "#prabhushriram",
                    "#ayodhya",
                    "#mandir",
                    "#jaishreeram",
                    "#poems",
                   ]                ],
                "caption": "कुछ कविता लिखी जाती है, कुछ कविता लिखनी पड़ती है ! \n\nधर्म और राजनीति के परे जाकर प्रभु श्री राम को ढूंढने की कोशिश इस कविता से कर रहा हूं। अगर आप के मन में भी यही सवाल उठ रहे है तो इसे जरूर शेअर कीजिएगा। मेरी मातृभाषा हिंदी नहीं है, इसलिए कुछ गलती हो जाए तो आशा करता हूं अपना समझकर आप माफ कर देंगे।\n\nShot By: @bhaveshpatange_97 \nSpecial Mention: @kaus_tube @fakira_1797 @_sani_trakari_ \n#rammandirayodhya #rammandir #shriram #prabhushriram #ayodhya #mandir #jaishreeram #poems #hindipoem #prabhushriram #rammandirbhumipujan #rammandirpranpratishtha #ram #india",
                "comments_count": 53,
                "likes_count": 370,
                "er": 33.73,
                "views": 14362,
                "posted_at": 1705840229,
                "posted_date": "Sun, 21 Jan 2024 12:30:29 GMT",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/C2XLaGHon4r.jpg",
                "sponsored": false,
                "external_links": [],
                "video": true,
                "post_type": "REEL",
                "mentions": [
                    "@bhaveshpatange_97",
                    "@kaus_tube",
                    "@fakira_1797",
                    "@_sani_trakari_"
                ],
                "location_name": ""
            },
           
            {
                "shortcode": "CxiMJ6EIcKL",
                "hashtags": [
                    "#Mumbai",
                    "#Ganeshotsav"
                ],
                "caption": "बाप्पा मोरया! \n\n#Mumbai #Ganeshotsav",
                "comments_count": 5,
                "likes_count": 455,
                "er": 36.68,
                "views": 4376,
                "posted_at": 1695471960,
                "posted_date": "Sat, 23 Sep 2023 12:26:00 GMT",
                "image_url": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/CxiMJ6EIcKL.jpg",
                "sponsored": false,
                "external_links": [],
                "video": true,
                "post_type": "REEL",
                "mentions": [],
                "location_name": ""
            },
            
        "engagement_trends": [
            {
                "2024-01-31": {
                    "engagement": 55.37
                }
            }
        ],
        "last_processed_at": "31/01/2024",
        "ig_user_id": "44746813468"
    },
    "get_audience": {
        "handle": "a_poetic_storyteller",
        "interests": {
            "Cinema & Entertainment": 41.86,
            "Fashion": 37.21,
            "Music & Dance": 34.88,
            "Photography": 30.23,
            "Travel & Adventure": 20.93,
            "Art & Design": 18.6,
            "Learning & Education": 16.28,
            "Parenting": 16.28,
            "Books & Writing": 13.95,
            "Food & Beverages": 11.63
        },
        "authenticity_distribution": {
            "real": 78.5,
            "fake": 2.5,
            "mass_followers": 12.7,
            "influencers": 6.3
        },
        "notable_followers": [
            "harshiljkaria",
            "shreya_anuroh",
            "artii_birajdarr",
            "sayalii_sonule",
            "marathicomedy992"
        ],
        "ig_user_id": "44746813468",
        "country_distribution": {},
        "age_group_distribution": {
            "13-17": 3.0,
            "18-24": 22.2,
            "25-34": 57.5,
            "35-44": 14.3,
            "45-54": 2.0,
            "55-64": 1.0,
            "65-": 0.0
        },
        "age_gender_distribution": {
            "13-17": {
                "male": 1.6,
                "female": 1.4
            },
            "18-24": {
                "male": 12.2,
                "female": 10.0
            },
            "25-34": {
                "male": 37.7,
                "female": 19.8
            },
            "35-44": {
                "male": 7.8,
                "female": 6.5
            },
            "45-54": {
                "male": 1.1,
                "female": 0.9
            },
            "55-64": {
                "male": 0.6,
                "female": 0.4
            },
            "65-": {
                "male": 0.0,
                "female": 0.0
            }
        },
        "gender_distribution": {
            "male": 60.0,
            "female": 40.0
        },
        "city_distribution": {
            "Pune": 35.71,
            "Mumbai": 23.21,
            "Nashik": 3.57,
            "Singapore": 3.57,
            "Kolhapur": 1.79,
            "Others": 32.14
        },
        "comments_sentiment_analysis": {
            "positives": 7,
            "negatives": 5,
            "neutral": 87
        },
        "comments": [
            {
                "text": "❤️🙌",
                "created_at": 1705733796,
                "sentiment": null,
                "like_count": "",
                "commenter": ""
            },
           
            {
                "text": "👏❤️",
                "created_at": 1705739919,
                "sentiment": null,
                "like_count": "",
                "commenter": ""
            },
            {
                "text": "Kyaaaa baaat hai ratnya ❤️\nJiyo 😘",
                "created_at": 1705764333,
                "sentiment": 0,
                "like_count": "",
                "commenter": ""
            },
            
        ],
        "comments_wordmap": [
            {
                "text": "bhai",
                "value": 5
            },
            {
                "text": "ratnya",
                "value": 5
            },
            {
                "text": "jamla",
                "value": 4
            },
            {
                "text": "ram",
                "value": 4
            },
            {
                "text": "भाऊ",
                "value": 4
            },
            
        ],
        "last_processed_at": "31/01/2024"
    },
    "unrelated_data": {
        "status": "success"
    }
}

Last updated