Data Refresh API
Get Public data and insights (without Audience demographics) of a creator using their Instagram or YouTube handle.
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
| ATTRIBUTES | DESCRIPTION |
|---|---|
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)
{
"request": {
"handle": "handle_name",
"request_type": "instagram"
},
"request_id": "request_identifier",
"response": {
"growth_trends": {
"engagement_trends": [
{
"2023-12-01": {
"followers": 0.8
}
},
{
"2023-12-04": {
"followers": 0.7
}
},
{
"2023-12-06": {
"followers": 1.1
}
}
],
"followers_trends": [
{
"2023-12-01": {
"followers": 750
}
},
{
"2023-12-04": {
"followers": 800
}
},
{
"2023-12-06": {
"followers": 1000
}
}
],
"monthly_engagement_growth": 0.54,
"monthly_followers_growth": 0.07,
"quaterly_engagement_growth": 0.69,
"quaterly_followers_growth": -0.07,
"yearly_engagement_growth": 0.42,
"yearly_followers_growth": -3.23
},
"posts": {
"non_video_posts": [
{
"caption": "asdas",
"comments_count": 1,
"engagement": 1.01,
"external_links": [
"https://asdas.com"
],
"hashtags": [
"#adsasd"
],
"likes_count": 10,
"posted_date": "2023-12-03",
"raw_image_url": "https://instagram.com/images/askdnanla",
"shortcode": "asda",
"sponsored": false
}
],
"video_posts": [
{
"caption": "hello world",
"comments_count": 12,
"engagement": 1.2,
"external_links": [
"https://asdas.com"
],
"hashtags": [
"#worth",
"#ad"
],
"likes_count": 24,
"posted_date": "2023-12-03",
"raw_image_url": "https://instagram.com/images/askdnanla",
"shortcode": "asdasd",
"sponsored": true,
"views": 123
}
]
},
"profile_details": {
"biography": "Co-Founder of Ylytic",
"brand_mentions": [
"@oi"
],
"category": "Business & Entrepreneurship",
"city": "Pune",
"country": "India",
"email": "anurag@ylytic.com",
"external_links": [
"https://www.ylytic.com"
],
"full_name": "Anurag Gupta",
"hashtags": [
"#growwithylytic"
],
"ig_category": "Business",
"mentions": [
"@mradulsharna"
],
"mobile": "9028055113",
"raw_image_url": "https://instagram.com/images/askdnanla"
},
"profile_overview": {
"content_per_week": 1.2,
"engagement": 1.1,
"followers_count": 10001,
"following_count": 200,
"handle": "anurag.itbhu05",
"ig_user_id": "123456",
"influencer_tier": "nano",
"post_count": 10
},
"reach_and_engagement_details": {}
},
"status": {
"code": 200,
"message": "success",
"request_at": "Wed, 06 Dec 2023 06:09:37 GMT",
"response_at": "Wed, 06 Dec 2023 06:09:47 GMT"
}
}Last updated