Social Note Post and Gallery Metadata API

API ID 14984

Extract structured social lifestyle post captions, hashtags, photo gallery arrays, video metadata, publication timestamps, and engagement metrics by post identifier.

API Documentation

Endpoints

Request
Search organic social lifestyle, beauty, fashion, food, travel, and product review posts in English or Chinese with server-side popularity or recency sorting and cursor pagination.
Endpoint ID: 39425
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39425/search+social+notes+by+keyword
INPUT PARAMETERS

Search Social Notes by Keyword — Endpoint Features

Object Description
keyword Required Search query in English or Chinese such as shanghai coffee, skincare routine, or 护肤.
sort_by Optional Server-side sort order: general, popularity_descending, or time_descending.
page_size Optional Number of posts returned per page between 1 and 20.
page Optional Page number starting at 1 when cursor is omitted.
cursor Optional Optional nextCursor pagination token from the previous response.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

keyword
sort_by
page_size
page
cursor
API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_b0f4dd90a0",
        "plugin": "social_notes",
        "endpoint": "search",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 6475.93,
        "timestamp": "2026-11-16T13:20:44.422971+00:00"
    },
    "data": {
        "keyword": "shanghai coffee",
        "resolvedKeyword": "上海咖啡",
        "sortBy": "general",
        "page": 1,
        "pageSize": 20,
        "count": 3,
        "hasMore": true,
        "nextCursor": "rn1_eyJhbGciOiJIUzI1NiJ9_example_cursor_token",
        "items": [
            {
                "id": "6ae1e9ad0000000023006beb",
                "idResolved": true,
                "type": "normal",
                "title": "上海热门咖啡店探店推荐合集4",
                "titleTranslated": null,
                "desc": "按图片顺序📷原图直出 1️⃣浅行深作·自家焙煎珈琲 奶咖可选梵高意式豆,偏浅烘带微酸甜感足。自家焙煎豆,主打法兰绒手冲",
                "url": "https://cdn.example.com/posts/6ae1e9ad0000000023006beb",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": false,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 145,
                "collectedCount": 113,
                "commentCount": 3,
                "sharedCount": 20,
                "viralScore": 460,
                "isPinned": null,
                "hashtags": [
                    "我的咖啡日记",
                    "咖啡探店",
                    "值得一去的咖啡店",
                    "不喝咖啡会死星人",
                    "cafe",
                    "一周咖啡不重样",
                    "coffee",
                    "上海咖啡店探店",
                    "重度咖啡爱好者",
                    "一起来喝咖啡"
                ],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": "2026-10-28T12:25:17+00:00",
                "updatedAt": "2026-10-30T15:51:54+00:00",
                "author": {
                    "id": "5f001bfbb95ad8983275c1f2",
                    "nickname": "creator_aebe",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f001bfbb95ad8983275c1f2"
                }
            },
            {
                "id": "6ae804c4000000000602f3cf",
                "idResolved": true,
                "type": "normal",
                "title": "去上海喝 墨尔本限定!",
                "titleTranslated": null,
                "desc": "淮海路有一家新开的澳式咖啡馆,装修质感很在线,喜欢绿色的露台,现在上海的天气最适合在露台享受咖啡了🍃。 当然要喝一杯墨",
                "url": "https://cdn.example.com/posts/6ae804c4000000000602f3cf",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": false,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 469,
                "collectedCount": 329,
                "commentCount": 56,
                "sharedCount": 499,
                "viralScore": 3291,
                "isPinned": null,
                "hashtags": [
                    "暗调摄影",
                    "静物摄影",
                    "店面设计",
                    "上海咖啡新店",
                    "上海新店",
                    "澳式咖啡",
                    "上海可可",
                    "Matemade",
                    "熔岩提拉米苏",
                    "烟熏可可"
                ],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": "2026-11-02T10:49:50+00:00",
                "updatedAt": "2026-11-02T10:49:50+00:00",
                "author": {
                    "id": "5f0093342590877f1928bfa0",
                    "nickname": "creator_1f64",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f0093342590877f1928bfa0"
                }
            },
            {
                "id": "6af6adf400000000180396af",
                "idResolved": true,
                "type": "normal",
                "title": "咖啡日记📓上海的咖啡还是太有趣了",
                "titleTranslated": null,
                "desc": "常年奶咖爱好者 来沪上“品鉴”咖啡了 (虽然只知道好喝还是不好喝) ◽️Oaks 19 【p1-2】 栗子特调🌰返场",
                "url": "https://cdn.example.com/posts/6af6adf400000000180396af",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": false,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 1547,
                "collectedCount": 1692,
                "commentCount": 38,
                "sharedCount": 1380,
                "viralScore": 10565,
                "isPinned": null,
                "hashtags": [
                    "喝一杯咖啡",
                    "人类需要咖啡",
                    "无咖啡不生活",
                    "上海咖啡",
                    "维也纳咖啡"
                ],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": "2026-11-13T06:28:04+00:00",
                "updatedAt": "2026-11-16T04:21:36+00:00",
                "author": {
                    "id": "5f009f1434acf1ca43b31c93",
                    "nickname": "creator_fc9d",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f009f1434acf1ca43b31c93"
                }
            }
        ]
    }
}
Search Social Notes by Keyword — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39425/search+social+notes+by+keyword?keyword=shanghai coffee&sort_by=popularity_descending&page_size=10&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Retrieve real-time viral lifestyle, fashion, beauty, food, travel, home, gaming, fitness, pet, kpop, baby, and tech posts across 15 discovery channels.
Endpoint ID: 39426
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39426/get+trending+category+feed
INPUT PARAMETERS

Get Trending Category Feed — Endpoint Features

Object Description
category Optional Channel slug such as food, recommend, fashion, beauty, travel, home, gaming, fitness, entertainment, career, love, pet, kpop, baby, or tech.
page_size Optional Number of trending posts to return between 1 and 35.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

category
page_size
API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_4f96998108",
        "plugin": "social_notes",
        "endpoint": "trending",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 1469.99,
        "timestamp": "2026-11-16T13:20:57.373319+00:00"
    },
    "data": {
        "category": "food",
        "channelId": "homefeed.food_v3",
        "categoryLabelEn": "Food & Cafes",
        "categoryLabelZh": "美食",
        "feedSource": "category_feed",
        "count": 3,
        "items": [
            {
                "id": "6a47b609000000001503e1c0",
                "idResolved": true,
                "type": "video",
                "title": "被这个汉堡香迷糊了!🔥",
                "titleTranslated": null,
                "desc": null,
                "url": "https://cdn.example.com/posts/6a47b609000000001503e1c0",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": true,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 5065,
                "collectedCount": 0,
                "commentCount": 0,
                "sharedCount": 0,
                "viralScore": 5065,
                "isPinned": null,
                "hashtags": [],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": null,
                "updatedAt": null,
                "author": {
                    "id": "5f00bf8bd368884946cc5e2d",
                    "nickname": "creator_3255",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00bf8bd368884946cc5e2d"
                }
            },
            {
                "id": "6919ad7d0000000007036976",
                "idResolved": true,
                "type": "video",
                "title": "挑战给1000位富豪上门烧烤,到底能否成功?",
                "titleTranslated": null,
                "desc": null,
                "url": "https://cdn.example.com/posts/6919ad7d0000000007036976",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": true,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 5985,
                "collectedCount": 0,
                "commentCount": 0,
                "sharedCount": 0,
                "viralScore": 5985,
                "isPinned": null,
                "hashtags": [],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": null,
                "updatedAt": null,
                "author": {
                    "id": "5f001abb0d678e8ab1d63a40",
                    "nickname": "creator_75ba",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f001abb0d678e8ab1d63a40"
                }
            },
            {
                "id": "690f58c800000000030236a5",
                "idResolved": true,
                "type": "video",
                "title": "梓渝XGISMOW泰国大屏打卡!",
                "titleTranslated": null,
                "desc": null,
                "url": "https://cdn.example.com/posts/690f58c800000000030236a5",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": true,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 2235,
                "collectedCount": 0,
                "commentCount": 0,
                "sharedCount": 0,
                "viralScore": 2235,
                "isPinned": null,
                "hashtags": [],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": null,
                "updatedAt": null,
                "author": {
                    "id": "5f005690ba3d49624f91d07d",
                    "nickname": "creator_977f",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f005690ba3d49624f91d07d"
                }
            }
        ]
    }
}
Get Trending Category Feed — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39426/get+trending+category+feed?category=food&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
List all 15 supported trending discovery channels, 3 server-side search sort modes, and 9 live broadcast categories.
Endpoint ID: 39427
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39427/get+trending+and+live+categories
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_510d0d2a9d",
        "plugin": "social_notes",
        "endpoint": "categories",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 0.07,
        "timestamp": "2026-11-16T13:20:37.945030+00:00"
    },
    "data": {
        "trendingCategories": [
            {
                "slug": "recommend",
                "channelId": "homefeed_recommend",
                "labelEn": "Recommended",
                "labelZh": "推荐",
                "feedSource": "category_feed"
            },
            {
                "slug": "fashion",
                "channelId": "homefeed.fashion_v3",
                "labelEn": "Fashion & OOTD",
                "labelZh": "穿搭",
                "feedSource": "category_feed"
            },
            {
                "slug": "beauty",
                "channelId": "homefeed.cosmetics_v3",
                "labelEn": "Beauty & Skincare",
                "labelZh": "彩妆",
                "feedSource": "category_feed"
            },
            {
                "slug": "food",
                "channelId": "homefeed.food_v3",
                "labelEn": "Food & Cafes",
                "labelZh": "美食",
                "feedSource": "category_feed"
            },
            {
                "slug": "travel",
                "channelId": "homefeed.travel_v3",
                "labelEn": "Travel & Destinations",
                "labelZh": "旅行",
                "feedSource": "category_feed"
            },
            {
                "slug": "home",
                "channelId": "homefeed.household_product_v3",
                "labelEn": "Home & Interior",
                "labelZh": "家居",
                "feedSource": "category_feed"
            },
            {
                "slug": "gaming",
                "channelId": "homefeed.gaming_v3",
                "labelEn": "Gaming & Anime",
                "labelZh": "游戏",
                "feedSource": "category_feed"
            },
            {
                "slug": "fitness",
                "channelId": "homefeed.fitness_v3",
                "labelEn": "Fitness & Wellness",
                "labelZh": "健身",
                "feedSource": "category_feed"
            },
            {
                "slug": "entertainment",
                "channelId": "homefeed.movie_and_tv_v3",
                "labelEn": "Movies, TV & Music",
                "labelZh": "影视",
                "feedSource": "category_feed"
            },
            {
                "slug": "career",
                "channelId": "homefeed.career_v3",
                "labelEn": "Career & Study",
                "labelZh": "职场",
                "feedSource": "category_feed"
            },
            {
                "slug": "love",
                "channelId": "homefeed.love_v3",
                "labelEn": "Relationships & Lifestyle",
                "labelZh": "情感",
                "feedSource": "category_feed"
            },
            {
                "slug": "pet",
                "channelId": "homefeed.pet",
                "labelEn": "Pets",
                "labelZh": "宠物",
                "feedSource": "category_feed"
            },
            {
                "slug": "kpop",
                "channelId": "homefeed.kpop_v3",
                "labelEn": "K-Pop",
                "labelZh": "韩流",
                "feedSource": "category_feed"
            },
            {
                "slug": "baby",
                "channelId": "homefeed.baby_v3",
                "labelEn": "Baby & Parenting",
                "labelZh": "母婴",
                "feedSource": "topic_hot_search"
            },
            {
                "slug": "tech",
                "channelId": "homefeed.tech_v3",
                "labelEn": "Tech & Digital",
                "labelZh": "数码",
                "feedSource": "topic_hot_search"
            }
        ],
        "searchSortModes": [
            {
                "value": "general",
                "aliases": [
                    "relevance",
                    "default",
                    "best_match"
                ],
                "description": "Default social_notes relevance ranking blending engagement and freshness."
            },
            {
                "value": "popularity_descending",
                "aliases": [
                    "popular",
                    "hot",
                    "most_liked"
                ],
                "description": "High-engagement viral notes (`最热`) ranked by likes, saves, and shares."
            },
            {
                "value": "time_descending",
                "aliases": [
                    "newest",
                    "latest",
                    "recent"
                ],
                "description": "Recency-weighted notes (`最新`) prioritizing newly published posts."
            }
        ],
        "liveCategories": [
            {
                "slug": "all",
                "upstreamCategoryId": "0",
                "labelEn": "All Active Streams",
                "labelZh": "全部"
            },
            {
                "slug": "game",
                "upstreamCategoryId": "1",
                "labelEn": "Gaming",
                "labelZh": "游戏"
            },
            {
                "slug": "beauty",
                "upstreamCategoryId": "2",
                "labelEn": "Beauty & Cosmetics",
                "labelZh": "才艺颜值"
            },
            {
                "slug": "fashion",
                "upstreamCategoryId": "2",
                "labelEn": "Fashion & Styling",
                "labelZh": "才艺颜值"
            },
            {
                "slug": "entertainment",
                "upstreamCategoryId": "2",
                "labelEn": "Talent & Entertainment",
                "labelZh": "才艺颜值"
            },
            {
                "slug": "life",
                "upstreamCategoryId": "3",
                "labelEn": "Lifestyle & Daily",
                "labelZh": "生活分享"
            },
            {
                "slug": "food",
                "upstreamCategoryId": "3",
                "labelEn": "Food & Culinary",
                "labelZh": "生活分享"
            },
            {
                "slug": "ecommerce",
                "upstreamCategoryId": "4",
                "labelEn": "Crafts, Jewelry & Goods",
                "labelZh": "兴趣手工"
            },
            {
                "slug": "knowledge",
                "upstreamCategoryId": "5",
                "labelEn": "Tech, Finance & Knowledge",
                "labelZh": "科技财经"
            }
        ]
    }
}
Get Trending and Live Categories — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39427/get+trending+and+live+categories' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Retrieve full post caption, hashtags, photo gallery images, video metadata, engagement metrics, publication timestamp, IP region, and creator summary for a 24-hex post identifier.
Endpoint ID: 39428
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39428/get+social+note+detail+and+media
INPUT PARAMETERS

Get Social Note Detail and Media — Endpoint Features

Object Description
note_id Required 24-character hex post identifier.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

note_id
API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_4dc16cea6e",
        "plugin": "social_notes",
        "endpoint": "note",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 2923.65,
        "timestamp": "2026-11-16T13:21:05.370035+00:00"
    },
    "data": {
        "id": "6ae1e9ad0000000023006beb",
        "idResolved": true,
        "type": "normal",
        "title": "上海热门咖啡店探店推荐合集4",
        "titleTranslated": null,
        "desc": "按图片顺序📷原图直出\n1️⃣浅行深作·自家焙煎珈琲\n奶咖可选梵高意式豆,偏浅烘带微酸甜感足。自家焙煎豆,主打法兰绒手冲口感丝滑柔和,没有强烈苦味。\n2️⃣Pincle coffee+ 拼一口咖啡(永康路店)\n世界烘焙冠军主理,豆子品质有底。我点的浅烘澳白。想喝清爽的选瑰冬,果味足价格不贵,当口粮咖啡很合适\n3️⃣BIG SUR COFFEE(永嘉路店)\n主打顶级豆单。强烈推荐点他家的瑰夏Combo:直接上巴拿马两大顶级庄园(Bambito水洗 + 翡翠庄园红标日晒)中式盖碗喝顶级瑰夏,仪式感和风味都拉满了\n4️⃣LUMO CORNER咖啡店\n原木风设计的社区质感咖啡店。推荐像我这样点一组Combo一豆两喝,体验感直接拉满\n5️⃣旺达WUNDER\n自家烘豆小店,豆单选择多。店里摆满动漫手办,空间不大但熟客多,适合路过安安静静喝一杯\n6️⃣In Dough We Trust\n复古法式甜品店。蛋糕奶油轻盈、橘子果肉清甜,配一杯拉花漂亮的澳白刚好解腻,是那种不踩雷的经典下午茶搭配\n7️⃣沪水焙煎室(淡水路店)\n满是手办和周杰伦歌单的复古宝藏小店。浅烘澳白很稳,果酸柔和,喝着顺口。如果想猎奇可以试试他家招牌的海苔Dirty\n8️⃣COFFEE AROMA\n主打自家烘焙的精品咖啡老店。浅烘澳白虽然价格偏贵一点点,但品质对得起价格豆子的风味被牛奶衬托得很干净,没有杂味\n9️⃣COFFEE IS(襄阳南路店)\n自家烘焙豆子。推荐直接点澳白,价格亲民,奶泡绵密、是那种对得起价格的日常口粮选择\n🔟coffee enough 咖啡足矣\n店里有一整面墙的中古滤杯和古董咖啡机。浅烘口感醇厚饱满,手冲也是招牌,水准很稳\n1️⃣1️⃣JAZO coffee 佳作咖啡\n我点的这杯澳白选了“甜瓜”,入口顺滑、果香明亮。开心果Dirty和苦瓜拿铁也是很多熟客的必点招牌\n1️⃣2️⃣LOOP LAB\n推荐点瑰夏拼配澳白,入口果香足,口感顺滑浓郁。想喝手冲可以试试日晒埃塞,甜感扎实,带点酵感酒香\n1️⃣3️⃣ BLUEKINGCOFFEE蓝京烘焙咖啡(静安店)\n开了多年的社区老店,自家烘豆,深烘豆子黑巧烟熏感明显,浓缩和牛奶层次分明\n#我的咖啡日记[话题]# #咖啡探店[话题]# #值得一去的咖啡店[话题]# #不喝咖啡会死星人[话题]# #cafe[话题]# #一周咖啡不重样[话题]# #coffee[话题]# #上海咖啡店探店[话题]# #重度咖啡爱好者[话题]# #一起来喝咖啡[话题]#",
        "url": "https://cdn.example.com/posts/6ae1e9ad0000000023006beb",
        "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
        "images": [
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg",
            "https://cdn.example.com/media/stream-asset.jpg"
        ],
        "imageCount": 13,
        "hasVideo": false,
        "videoUrl": null,
        "videoDurationSec": null,
        "videoUrlExpiresAt": null,
        "likedCount": 145,
        "collectedCount": 113,
        "commentCount": 3,
        "sharedCount": 20,
        "viralScore": 460,
        "isPinned": null,
        "hashtags": [
            "我的咖啡日记",
            "咖啡探店",
            "值得一去的咖啡店",
            "不喝咖啡会死星人",
            "cafe",
            "一周咖啡不重样",
            "coffee",
            "上海咖啡店探店",
            "重度咖啡爱好者",
            "一起来喝咖啡"
        ],
        "mentions": [],
        "ipLocation": "巴西",
        "publishedAt": "2026-10-28T12:25:17+00:00",
        "updatedAt": "2026-10-28T12:25:17+00:00",
        "author": {
            "id": "5f001bfbb95ad8983275c1f2",
            "nickname": "creator_aebe",
            "redId": null,
            "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
            "profileUrl": "https://cdn.example.com/users/5f001bfbb95ad8983275c1f2"
        }
    }
}
Get Social Note Detail and Media — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39428/get+social+note+detail+and+media?note_id=6ae1e9ad0000000023006beb' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Paginate root comments and inline nested replies for a post identifier with commenter IP region, comment photos, like counts, and buyer-intent detection.
Endpoint ID: 39430
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39430/get+post+comments+and+replies
INPUT PARAMETERS

Get Post Comments and Replies — Endpoint Features

Object Description
note_id Required 24-character hex post identifier.
include_replies Optional Set to true to include inline nested replies under each root comment.
page_size Optional Number of root comments per page between 1 and 20.
cursor Optional Optional nextCursor token for comment pagination.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

note_id
include_replies
page_size
cursor
API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_6d7aaf3d31",
        "plugin": "social_notes",
        "endpoint": "comments",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 347.07,
        "timestamp": "2026-11-16T13:21:17.485554+00:00"
    },
    "data": {
        "noteId": "6ad719520000000026016b4f",
        "count": 5,
        "rootCount": 3,
        "replyCount": 2,
        "hasMore": false,
        "nextCursor": null,
        "comments": [
            {
                "id": "6ad740c6000000000200f683",
                "noteId": "6ad719520000000026016b4f",
                "parentCommentId": null,
                "content": "老婆我要去听现场版的1424了[自拍R]",
                "likeCount": 0,
                "subCommentCount": 1,
                "subCommentHasMore": false,
                "ipLocation": "福建",
                "createdAt": "2026-10-20T10:21:59+00:00",
                "pictures": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "isBuyerIntent": false,
                "author": {
                    "id": "5f00f3e0f64dfc494a23d930",
                    "nickname": "user_797b",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00f3e0f64dfc494a23d930"
                },
                "replies": [
                    {
                        "id": "6ad7418b000000001300c4ce",
                        "noteId": "6ad719520000000026016b4f",
                        "parentCommentId": "6ad740c6000000000200f683",
                        "content": "哇塞[哇R][哇R][哇R]",
                        "likeCount": 0,
                        "subCommentCount": 0,
                        "subCommentHasMore": false,
                        "ipLocation": "陕西",
                        "createdAt": "2026-10-20T10:25:16+00:00",
                        "pictures": [],
                        "isBuyerIntent": false,
                        "author": {
                            "id": "5f00f051ffc2e2c16a9f4f1e",
                            "nickname": "user_aa9f",
                            "redId": null,
                            "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                            "profileUrl": "https://cdn.example.com/users/5f00f051ffc2e2c16a9f4f1e"
                        },
                        "replies": []
                    }
                ]
            },
            {
                "id": "6ad73bae000000000b014d42",
                "noteId": "6ad719520000000026016b4f",
                "parentCommentId": null,
                "content": "变美美纪录片",
                "likeCount": 0,
                "subCommentCount": 1,
                "subCommentHasMore": false,
                "ipLocation": "陕西",
                "createdAt": "2026-10-20T10:00:14+00:00",
                "pictures": [],
                "isBuyerIntent": false,
                "author": {
                    "id": "5f001df488925212bf0f7f43",
                    "nickname": "user_f7c9",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f001df488925212bf0f7f43"
                },
                "replies": [
                    {
                        "id": "6ad73f3d000000000f030a16",
                        "noteId": "6ad719520000000026016b4f",
                        "parentCommentId": "6ad73bae000000000b014d42",
                        "content": "非常实用的分享,已收藏!",
                        "likeCount": 0,
                        "subCommentCount": 0,
                        "subCommentHasMore": false,
                        "ipLocation": "陕西",
                        "createdAt": "2026-10-20T10:15:26+00:00",
                        "pictures": [
                            "https://cdn.example.com/media/stream-asset.jpg"
                        ],
                        "isBuyerIntent": false,
                        "author": {
                            "id": "5f00f051ffc2e2c16a9f4f1e",
                            "nickname": "user_aa9f",
                            "redId": null,
                            "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                            "profileUrl": "https://cdn.example.com/users/5f00f051ffc2e2c16a9f4f1e"
                        },
                        "replies": []
                    }
                ]
            },
            {
                "id": "6ad78cd6000000000202b7ed",
                "noteId": "6ad719520000000026016b4f",
                "parentCommentId": null,
                "content": "[两颗心R][红色心形R][心心眼R]",
                "likeCount": 0,
                "subCommentCount": 0,
                "subCommentHasMore": false,
                "ipLocation": "云南",
                "createdAt": "2026-10-20T15:46:31+00:00",
                "pictures": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "isBuyerIntent": false,
                "author": {
                    "id": "5f00ee0a74e6b34e5a1fd7d9",
                    "nickname": "user_5625",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00ee0a74e6b34e5a1fd7d9"
                },
                "replies": []
            }
        ]
    }
}
Get Post Comments and Replies — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39430/get+post+comments+and+replies?note_id=6ae1e9ad0000000023006beb&include_replies=true&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Audit a creator profile, official verification badge, follower count, total likes and saves, public bio details, and latest published portfolio posts from a 24-hex creator identifier or handle.
Endpoint ID: 39431
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39431/get+creator+kol+profile+and+portfolio
INPUT PARAMETERS

Get Creator KOL Profile and Portfolio — Endpoint Features

Object Description
include_notes Optional Set to true to embed the creator latest public portfolio posts.
user_id Required 24-character hex creator identifier or account handle.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

include_notes
user_id
API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_5ed070f5d8",
        "plugin": "social_notes",
        "endpoint": "user",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 591.7,
        "timestamp": "2026-11-16T13:21:18.079746+00:00"
    },
    "data": {
        "userId": "5f00f850a38109f090dd89b4",
        "nickname": "creator_7243",
        "redId": "560472404",
        "bio": "专注城市精品咖啡与生活方式测评,分享真实日常探店记录。",
        "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
        "bannerUrl": "https://cdn.example.com/media/stream-asset.jpg",
        "gender": "unknown",
        "ipLocation": "山东",
        "verified": false,
        "verificationBadge": "Individual",
        "verificationDesc": null,
        "followerCount": 10000,
        "followerCountDisplay": "10k+",
        "followingCount": 10,
        "followingCountDisplay": "10+",
        "totalLikesAndCollects": 10000,
        "totalLikesAndCollectsDisplay": "10k+",
        "profileUrl": "https://cdn.example.com/users/5f00f850a38109f090dd89b4",
        "contactInfo": {
            "email": null,
            "wechat": null,
            "mcn": null
        },
        "portfolioCount": 2,
        "notes": [
            {
                "id": "6afaac6f0000000026012d7e",
                "idResolved": true,
                "type": "video",
                "title": "看懂护肤成分,轻松搞定宝宝泛红干脸",
                "titleTranslated": null,
                "desc": null,
                "url": "https://cdn.example.com/posts/6afaac6f0000000026012d7e",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": true,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 684,
                "collectedCount": 323,
                "commentCount": 108,
                "sharedCount": 7,
                "viralScore": 1682,
                "isPinned": false,
                "hashtags": [],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": "2026-11-16T07:10:39+00:00",
                "updatedAt": "2026-11-16T07:11:46+00:00",
                "author": {
                    "id": "5f00f850a38109f090dd89b4",
                    "nickname": "creator_7243",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00f850a38109f090dd89b4"
                }
            },
            {
                "id": "6ae46c400000000003017edf",
                "idResolved": true,
                "type": "video",
                "title": "新生儿皮肤养护,放过自带天然保护膜",
                "titleTranslated": null,
                "desc": null,
                "url": "https://cdn.example.com/posts/6ae46c400000000003017edf",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": true,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 6758,
                "collectedCount": 4197,
                "commentCount": 184,
                "sharedCount": 7,
                "viralScore": 15732,
                "isPinned": false,
                "hashtags": [],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": "2026-10-30T12:17:36+00:00",
                "updatedAt": "2026-10-30T12:17:36+00:00",
                "author": {
                    "id": "5f00f850a38109f090dd89b4",
                    "nickname": "creator_7243",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00f850a38109f090dd89b4"
                }
            }
        ]
    }
}
Get Creator KOL Profile and Portfolio — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39431/get+creator+kol+profile+and+portfolio?include_notes=true&user_id=5ca3aa47000000001001bc3d' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Paginate a creator published lifestyle and product review posts with pinned post flags, engagement counts, and cursor pagination.
Endpoint ID: 39432
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39432/get+creator+published+posts+feed
INPUT PARAMETERS

Get Creator Published Posts Feed — Endpoint Features

Object Description
user_id Required 24-character hex creator identifier or account handle.
page_size Optional Number of creator posts per page between 1 and 20.
cursor Optional Optional nextCursor token for portfolio pagination.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

user_id
page_size
cursor
API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_f2ee34ec4e",
        "plugin": "social_notes",
        "endpoint": "user-notes",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 703.18,
        "timestamp": "2026-11-16T13:21:18.785998+00:00"
    },
    "data": {
        "userId": "5f00f850a38109f090dd89b4",
        "nickname": "creator_7243",
        "page": 1,
        "count": 3,
        "hasMore": true,
        "nextCursor": "rn1_eyJhbGciOiJIUzI1NiJ9_example_cursor_token",
        "items": [
            {
                "id": "6afaac6f0000000026012d7e",
                "idResolved": true,
                "type": "video",
                "title": "看懂护肤成分,轻松搞定宝宝泛红干脸",
                "titleTranslated": null,
                "desc": null,
                "url": "https://cdn.example.com/posts/6afaac6f0000000026012d7e",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": true,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 684,
                "collectedCount": 323,
                "commentCount": 108,
                "sharedCount": 7,
                "viralScore": 1682,
                "isPinned": false,
                "hashtags": [],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": "2026-11-16T07:10:39+00:00",
                "updatedAt": "2026-11-16T07:11:46+00:00",
                "author": {
                    "id": "5f00f850a38109f090dd89b4",
                    "nickname": "creator_7243",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00f850a38109f090dd89b4"
                }
            },
            {
                "id": "6ae46c400000000003017edf",
                "idResolved": true,
                "type": "video",
                "title": "新生儿皮肤养护,放过自带天然保护膜",
                "titleTranslated": null,
                "desc": null,
                "url": "https://cdn.example.com/posts/6ae46c400000000003017edf",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": true,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 6758,
                "collectedCount": 4197,
                "commentCount": 184,
                "sharedCount": 7,
                "viralScore": 15732,
                "isPinned": false,
                "hashtags": [],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": "2026-10-30T12:17:36+00:00",
                "updatedAt": "2026-10-30T12:17:36+00:00",
                "author": {
                    "id": "5f00f850a38109f090dd89b4",
                    "nickname": "creator_7243",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00f850a38109f090dd89b4"
                }
            },
            {
                "id": "6acc7988000000001c02d0eb",
                "idResolved": true,
                "type": "video",
                "title": "选奶粉别被宣传带跑,启赋家族选购不纠结!",
                "titleTranslated": null,
                "desc": null,
                "url": "https://cdn.example.com/posts/6acc7988000000001c02d0eb",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": true,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 16000,
                "collectedCount": 7914,
                "commentCount": 290,
                "sharedCount": 23,
                "viralScore": 32790,
                "isPinned": false,
                "hashtags": [],
                "mentions": [],
                "ipLocation": null,
                "publishedAt": "2026-10-12T06:57:18+00:00",
                "updatedAt": "2026-10-12T06:12:52+00:00",
                "author": {
                    "id": "5f00f850a38109f090dd89b4",
                    "nickname": "creator_7243",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00f850a38109f090dd89b4"
                }
            }
        ]
    }
}
Get Creator Published Posts Feed — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39432/get+creator+published+posts+feed?user_id=5ca3aa47000000001001bc3d&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Discover currently broadcasting live commerce, fashion, beauty, food, and lifestyle rooms with viewer counts, shopping goods indicators, and host details.
Endpoint ID: 39433
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39433/get+active+live+commerce+streams
INPUT PARAMETERS

Get Active Live Commerce Streams — Endpoint Features

Object Description
category Optional Live category: all, ecommerce, fashion, beauty, life, food, knowledge, game, or entertainment.
page_size Optional Number of active live rooms to return between 1 and 27.
cursor Optional Optional nextCursor token for live feed pagination.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

category
page_size
cursor
API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_15a9bdf554",
        "plugin": "social_notes",
        "endpoint": "live-rooms",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 1735.52,
        "timestamp": "2026-11-16T13:21:20.863894+00:00"
    },
    "data": {
        "category": "all",
        "count": 3,
        "hasMore": true,
        "nextCursor": "rn1_eyJhbGciOiJIUzI1NiJ9_example_cursor_token",
        "items": [
            {
                "roomId": "570544269383033022",
                "roomTitle": "治愈",
                "roomStatus": 2,
                "category": "all",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "viewerCount": 61,
                "viewersTotalUv": 2685,
                "likedCount": 0,
                "hasGoods": false,
                "isPaidLive": false,
                "flvUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "hlsUrl": null,
                "pinnedAnnouncement": null,
                "buyerIntentKeywords": [],
                "host": {
                    "id": "5f00b3ffd24150c907e8919b",
                    "nickname": "creator_d689",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00b3ffd24150c907e8919b"
                },
                "liveChat": null
            },
            {
                "roomId": "570544248109707895",
                "roomTitle": "红薯第一女唱播~",
                "roomStatus": 2,
                "category": "all",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "viewerCount": 27,
                "viewersTotalUv": 1135,
                "likedCount": 0,
                "hasGoods": false,
                "isPaidLive": false,
                "flvUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "hlsUrl": null,
                "pinnedAnnouncement": null,
                "buyerIntentKeywords": [],
                "host": {
                    "id": "5f0046616a33f3d7e76f4877",
                    "nickname": "creator_1339",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f0046616a33f3d7e76f4877"
                },
                "liveChat": null
            },
            {
                "roomId": "570544219621994079",
                "roomTitle": "哥哥快来守护妹妹好吗摔的好痛痛哦",
                "roomStatus": 2,
                "category": "all",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "viewerCount": 70,
                "viewersTotalUv": 7851,
                "likedCount": 0,
                "hasGoods": false,
                "isPaidLive": false,
                "flvUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "hlsUrl": null,
                "pinnedAnnouncement": null,
                "buyerIntentKeywords": [],
                "host": {
                    "id": "5f00224cc32d22bb69c51b14",
                    "nickname": "creator_e9a9",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00224cc32d22bb69c51b14"
                },
                "liveChat": null
            }
        ]
    }
}
Get Active Live Commerce Streams — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39433/get+active+live+commerce+streams?category=all&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Inspect an active live broadcast room viewer metrics, cumulative unique viewers, e-commerce shopping status, host profile, and live chat messages.
Endpoint ID: 39434
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39434/get+live+stream+room+snapshot
INPUT PARAMETERS

Get Live Stream Room Snapshot — Endpoint Features

Object Description
room_id Required Numeric active live broadcast room identifier.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

room_id
API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_68c2ea1339",
        "plugin": "social_notes",
        "endpoint": "live-room",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 1484.97,
        "timestamp": "2026-11-16T13:21:22.351036+00:00"
    },
    "data": {
        "roomId": "570544269383033022",
        "roomTitle": "那就等起风的时候,来看我吧",
        "roomStatus": 2,
        "category": "all",
        "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
        "viewerCount": 60,
        "viewersTotalUv": 3017,
        "likedCount": 1000,
        "hasGoods": false,
        "isPaidLive": false,
        "flvUrl": "https://cdn.example.com/media/stream-asset.jpg",
        "hlsUrl": "https://cdn.example.com/media/stream-asset.jpg",
        "pinnedAnnouncement": "👾卡皮巴拉/300人气票点歌/首次家团送歌半首",
        "buyerIntentKeywords": [
            "能穿",
            "什么码",
            "尺码"
        ],
        "host": {
            "id": "5f00b3ffd24150c907e8919b",
            "nickname": "creator_d689",
            "redId": null,
            "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
            "profileUrl": "https://cdn.example.com/users/5f00b3ffd24150c907e8919b"
        },
        "liveChat": [
            {
                "id": "7708758786546591182",
                "text": "ohno",
                "authorId": "5f00b0ad9ca4a456a08fae5d",
                "authorNickname": "user_41b9",
                "authorAvatarUrl": "https://cdn.example.com/media/stream-asset.jpg"
            },
            {
                "id": "7708758722003860199",
                "text": "少打听",
                "authorId": "5f004ef0a61e0cd6adb9410a",
                "authorNickname": "user_91c3",
                "authorAvatarUrl": "https://cdn.example.com/media/stream-asset.jpg"
            },
            {
                "id": "7708758267219030148",
                "text": "no 不是漏吗 有口音[呃R]",
                "authorId": "5f00d3aa84ab161a00600911",
                "authorNickname": "user_e74e",
                "authorAvatarUrl": "https://cdn.example.com/media/stream-asset.jpg"
            }
        ]
    }
}
Get Live Stream Room Snapshot — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39434/get+live+stream+room+snapshot?room_id=570544427492044384' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Concurrently retrieve post details, captions, hashtags, engagement metrics, and creator summaries for multiple comma-separated 24-hex post identifiers in a single request.
Endpoint ID: 39466
GET https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39466/batch+enrich+multiple+posts
INPUT PARAMETERS

Batch Enrich Multiple Posts — Endpoint Features

Object Description
note_ids Required Comma-separated list of 2 to 5 24-hex post identifiers.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

note_ids
API EXAMPLE RESPONSE
JSON
{
    "success": true,
    "meta": {
        "request_id": "req_rn_894ee12315",
        "plugin": "social_notes",
        "endpoint": "notes-batch",
        "tier": "PRO",
        "cached": false,
        "latency_ms": 3384.8,
        "timestamp": "2026-11-16T13:21:17.135342+00:00"
    },
    "data": {
        "requestedCount": 2,
        "returnedCount": 2,
        "failedNoteIds": [],
        "items": [
            {
                "id": "6ae1e9ad0000000023006beb",
                "idResolved": true,
                "type": "normal",
                "title": "上海热门咖啡店探店推荐合集4",
                "titleTranslated": null,
                "desc": "按图片顺序📷原图直出\n1️⃣浅行深作·自家焙煎珈琲\n奶咖可选梵高意式豆,偏浅烘带微酸甜感足。自家焙煎豆,主打法兰绒手冲口感丝滑柔和,没有强烈苦味。\n2️⃣Pincle coffee+ 拼一口咖啡(永康路店)\n世界烘焙冠军主理,豆子品质有底。我点的浅烘澳白。想喝清爽的选瑰冬,果味足价格不贵,当口粮咖啡很合适\n3️⃣BIG SUR COFFEE(永嘉路店)\n主打顶级豆单。强烈推荐点他家的瑰夏Combo:直接上巴拿马两大顶级庄园(Bambito水洗 + 翡翠庄园红标日晒)中式盖碗喝顶级瑰夏,仪式感和风味都拉满了\n4️⃣LUMO CORNER咖啡店\n原木风设计的社区质感咖啡店。推荐像我这样点一组Combo一豆两喝,体验感直接拉满\n5️⃣旺达WUNDER\n自家烘豆小店,豆单选择多。店里摆满动漫手办,空间不大但熟客多,适合路过安安静静喝一杯\n6️⃣In Dough We Trust\n复古法式甜品店。蛋糕奶油轻盈、橘子果肉清甜,配一杯拉花漂亮的澳白刚好解腻,是那种不踩雷的经典下午茶搭配\n7️⃣沪水焙煎室(淡水路店)\n满是手办和周杰伦歌单的复古宝藏小店。浅烘澳白很稳,果酸柔和,喝着顺口。如果想猎奇可以试试他家招牌的海苔Dirty\n8️⃣COFFEE AROMA\n主打自家烘焙的精品咖啡老店。浅烘澳白虽然价格偏贵一点点,但品质对得起价格豆子的风味被牛奶衬托得很干净,没有杂味\n9️⃣COFFEE IS(襄阳南路店)\n自家烘焙豆子。推荐直接点澳白,价格亲民,奶泡绵密、是那种对得起价格的日常口粮选择\n🔟coffee enough 咖啡足矣\n店里有一整面墙的中古滤杯和古董咖啡机。浅烘口感醇厚饱满,手冲也是招牌,水准很稳\n1️⃣1️⃣JAZO coffee 佳作咖啡\n我点的这杯澳白选了“甜瓜”,入口顺滑、果香明亮。开心果Dirty和苦瓜拿铁也是很多熟客的必点招牌\n1️⃣2️⃣LOOP LAB\n推荐点瑰夏拼配澳白,入口果香足,口感顺滑浓郁。想喝手冲可以试试日晒埃塞,甜感扎实,带点酵感酒香\n1️⃣3️⃣ BLUEKINGCOFFEE蓝京烘焙咖啡(静安店)\n开了多年的社区老店,自家烘豆,深烘豆子黑巧烟熏感明显,浓缩和牛奶层次分明\n#我的咖啡日记[话题]# #咖啡探店[话题]# #值得一去的咖啡店[话题]# #不喝咖啡会死星人[话题]# #cafe[话题]# #一周咖啡不重样[话题]# #coffee[话题]# #上海咖啡店探店[话题]# #重度咖啡爱好者[话题]# #一起来喝咖啡[话题]#",
                "url": "https://cdn.example.com/posts/6ae1e9ad0000000023006beb",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg",
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 13,
                "hasVideo": false,
                "videoUrl": null,
                "videoDurationSec": null,
                "videoUrlExpiresAt": null,
                "likedCount": 145,
                "collectedCount": 113,
                "commentCount": 3,
                "sharedCount": 20,
                "viralScore": 460,
                "isPinned": null,
                "hashtags": [
                    "我的咖啡日记",
                    "咖啡探店",
                    "值得一去的咖啡店",
                    "不喝咖啡会死星人",
                    "cafe",
                    "一周咖啡不重样",
                    "coffee",
                    "上海咖啡店探店",
                    "重度咖啡爱好者",
                    "一起来喝咖啡"
                ],
                "mentions": [],
                "ipLocation": "巴西",
                "publishedAt": "2026-10-28T12:25:17+00:00",
                "updatedAt": "2026-10-28T12:25:17+00:00",
                "author": {
                    "id": "5f001bfbb95ad8983275c1f2",
                    "nickname": "creator_aebe",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f001bfbb95ad8983275c1f2"
                }
            },
            {
                "id": "6ad719520000000026016b4f",
                "idResolved": true,
                "type": "video",
                "title": "晚间护肤|给皮肤降个温 懒人精简版越养越透",
                "titleTranslated": null,
                "desc": "#晚间护肤[话题]##精简护肤[话题]##懒人护肤[话题]##护肤打卡[话题]##降温护肤[话题]##素颜养成[话题]##每日护肤[话题]# #我的护肤日记[话题]# #护肤[话题]#",
                "url": "https://cdn.example.com/posts/6ad719520000000026016b4f",
                "coverUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "images": [
                    "https://cdn.example.com/media/stream-asset.jpg"
                ],
                "imageCount": 1,
                "hasVideo": true,
                "videoUrl": "https://cdn.example.com/media/stream-asset.jpg",
                "videoDurationSec": 63,
                "videoUrlExpiresAt": "2026-11-20T01:21:16+00:00",
                "likedCount": 294,
                "collectedCount": 72,
                "commentCount": 6,
                "sharedCount": 4,
                "viralScore": 472,
                "isPinned": null,
                "hashtags": [
                    "晚间护肤",
                    "精简护肤",
                    "懒人护肤",
                    "护肤打卡",
                    "降温护肤",
                    "素颜养成",
                    "每日护肤",
                    "我的护肤日记",
                    "护肤"
                ],
                "mentions": [],
                "ipLocation": "陕西",
                "publishedAt": "2026-10-20T07:33:38+00:00",
                "updatedAt": "2026-10-20T07:33:39+00:00",
                "author": {
                    "id": "5f00f051ffc2e2c16a9f4f1e",
                    "nickname": "creator_7cd4",
                    "redId": null,
                    "avatarUrl": "https://cdn.example.com/media/stream-asset.jpg",
                    "profileUrl": "https://cdn.example.com/users/5f00f051ffc2e2c16a9f4f1e"
                }
            }
        ]
    }
}
Batch Enrich Multiple Posts — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14984/social+note+post+and+gallery+metadata+api/39466/batch+enrich+multiple+posts?note_ids=6ae1e9ad0000000023006beb,6ad719520000000026016b4f' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Social Note Post and Gallery Metadata API simply include your bearer token in the Authorization header.

Headers
Header Description
Authorization Required Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

Starts at
$10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring

Overview

Extract structured social lifestyle post captions, hashtags, photo gallery arrays, video metadata, publication timestamps, and engagement metrics by post identifier.

Social Note Post and Gallery Metadata API FAQs

Yes. The Search Social Notes by Keyword endpoint accepts both Chinese and English queries, automatically mapping common English beauty, fashion, food, and travel phrases into native Chinese search terms while keeping brand names intact.

No. Bare 24-character hexadecimal post and creator identifiers work directly without requiring user accounts, cookies, or expiring access tokens.

Yes. All gallery images are normalized to standard HTTPS JPEG format and video posts include structured media metadata and expiration timestamps.

Yes. Post, comment, and creator endpoints automatically isolate and resolve embedded mobile share links in a single API call.

Call Get Creator KOL Profile and Portfolio to inspect follower count, total likes and saves, verification badge, and published post save-to-like ratios in a single request.

Each endpoint returns structured data related to social media posts, including captions, hashtags, media (images/videos), engagement metrics, publication timestamps, and creator profiles. For example, the Get Social Note Detail and Media endpoint provides full post captions, hashtags, and engagement metrics.

Key fields include "id" (post identifier), "title" (post title), "desc" (description), "items" (array of posts), "viewerCount" (live stream viewers), and "likeCount" (engagement metrics). Each endpoint has specific fields relevant to its function.

Response data is organized into a "meta" section containing request details and a "data" section with the relevant content. For example, the data section in the Get Trending Category Feed includes "category," "count," and "items," which detail the posts retrieved.

Information varies by endpoint: the Search Social Notes by Keyword provides posts sorted by popularity or recency, while Get Creator KOL Profile and Portfolio offers insights into creator metrics like follower count and engagement. Each endpoint serves specific data needs.

Parameters vary by endpoint; for instance, the Search Social Notes by Keyword accepts "keyword," "sortBy," and pagination parameters like "page" and "pageSize." Users can customize requests to filter results based on their needs.

Users can analyze engagement metrics to assess post popularity, track trends in specific categories, or evaluate creator profiles for influencer marketing. For example, using the Get Creator Published Posts Feed, brands can identify potential influencers based on their content and engagement.

Typical use cases include market research, influencer marketing analysis, content strategy development, and trend tracking in lifestyle and product reviews. Brands can leverage insights to tailor campaigns and improve audience engagement.

Data accuracy is maintained through continuous monitoring of social media platforms and regular updates to the API. The structured format ensures consistency, and the use of unique identifiers helps in retrieving precise information for each post or creator.

General FAQs

To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.

You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.

The free trial lasts for 7 days and allows you to make up to 50 API requests.

No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.

Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

You can monitor your API usage through the response headers included with every request:

x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.

Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund


Related APIs