Join Room

Join the room/live as a viewer

PREMIUM ENDPOINT

Join the room/live as a viewer

GET https://kitkot.xyz/api/live/join

Allows you to join the live as if you were a real human watching it

Query Parameters

Name
Type
Description

api_key*

String

The api_key you got when purchasing our service

session_key*

String

The session_key you got from our login endpoint

room_id*

String

The room_id of the room/live to join

anchor_id

String

The anchor_id of the room/live (Live feed response includes this, provide it if you want to "act" more like a "real human")

request_id

String

The request_id returned from the response you got on the action before joining the room/live (Not required but suggested)

{
  code: 200,
  msg: 'success',
  linked_mic: {
    linked_users: [],
    show_user_list: [],
    rival_anchor_id: 0,
    multi_live_enum: 1,
    battle_scores: [],
    channel_id: 0,
    followed_count: 0,
    audience_id_list: [0, 0]
  },
  owner: {
    allow_find_by_contacts: false,
    allow_others_download_video: false,
    allow_others_download_when_sharing_video: false,
    allow_share_show_profile: false,
    allow_show_in_gossip: false,
    allow_show_my_action: false,
    allow_strange_comment: false,
    allow_unfollower_comment: false,
    allow_use_linkmic: false,
    avatar_large: {
      avg_color: '',
      height: 0,
      image_type: 0,
      is_animated: false,
      open_web_url: '',
      uri: '',
      url_list: [Array],
      width: 0
    },
    avatar_medium: {
      avg_color: '',
      height: 0,
      image_type: 0,
      is_animated: false,
      open_web_url: '',
      uri: '',
      url_list: [Array],
      width: 0
    },
    avatar_thumb: {
      avg_color: '',
      height: 0,
      image_type: 0,
      is_animated: false,
      open_web_url: '',
      uri: '',
      url_list: [Array],
      width: 0
    },
    badge_image_list: [],
    badge_list: [],
    bg_img_url: '',
    bio_description: '',
    block_status: 0,
    border_list: [],
    comment_restrict: 0,
    commerce_webcast_config_ids: [],
    constellation: '',
    create_time: 0,
    disable_ichat: 0,
    display_id: '',
    enable_ichat_img: 0,
    exp: 0,
    fan_ticket_count: 0,
    fold_stranger_chat: false,
    follow_info: {
      follow_status: 0,
      follower_count: 6558,
      following_count: 623,
      push_status: 0
    },
    follow_status: 0,
    ichat_restrict_type: 0,
    id: 0,
    id_str: '',
    is_follower: false,
    is_following: false,
    link_mic_stats: 2,
    media_badge_image_list: [],
    mint_type_label: [],
    modify_time: 1670933176,
    need_profile_guide: false,
    new_real_time_icons: [],
    nickname: '',
    own_room: { room_ids: [Array], room_ids_str: [Array] },
    pay_grade: {
      grade_banner: '',
      grade_describe: '',
      grade_icon_list: [],
      level: 0,
      name: '',
      next_name: '',
      next_privileges: '',
      score: 0,
      screen_chat_type: 0,
      upgrade_need_consume: 0
    },
    pay_score: 0,
    pay_scores: 0,
    push_comment_status: false,
    push_digg: false,
    push_follow: false,
    push_friend_action: false,
    push_ichat: false,
    push_status: false,
    push_video_post: false,
    push_video_recommend: false,
    real_time_icons: [],
    scm_label: '',
    sec_uid: '',        
    secret: 0,
    share_qrcode_uri: '',
    special_id: '',
    status: 1,
    subscribe_info: {
      badge: {},
      enable_subscription: false,
      is_in_grace_period: false,
      is_subscribe: false,
      is_subscribed_to_anchor: false,
      qualification: true,
      subscriber_count: 0
    },
    ticket_count: 0,
    top_fans: [],
    top_vip_no: 0,
    upcoming_event_list: [],
    user_attr: {
      admin_permissions: {},
      is_admin: false,
      is_muted: false,
      is_super_admin: false,
      mute_duration: 0
    },
    user_role: 0,
    verified: false,
    verified_content: '',
    verified_reason: '',
    with_car_management_permission: false,
    with_commerce_permission: false,
    with_fusion_shop_entry: false
  },
  room_auth: {
    Banner: 1,
    BroadcastMessage: 1,
    Chat: true,
    ChatL2: true,
    ChatSubOnly: false,
    CommercePermission: 0,
    CommunityFlagged: false,
    CommunityFlaggedReview: false,
    CustomizablePoll: 1,
    Danmaku: false,
    Digg: true,
    DonationSticker: 1,
    EventPromotion: 0,
    Explore: true,
    GameRankingSwitch: 0,
    Gift: true,
    GiftAnchorMt: 1,
    GiftPoll: 0,
    GoldenEnvelope: 2,
    GoldenEnvelopeActivity: 2,
    InteractionQuestion: true,
    Landscape: 2,
    LandscapeChat: 0,
    LuckMoney: true,
    Pictionary: 0,
    PictionaryBubble: 1,
    PictionaryPermission: 1,
    Poll: 0,
    Promote: false,
    PromoteOther: 2,
    Props: false,
    PublicScreen: 1,
    QuickChat: 1,
    Rank: 1,
    RoomContributor: false,
    Share: true,
    ShareEffect: 0,
    ShoppingRanking: 0,
    UserCard: true,
    UserCount: 1,
    Viewers: true,
    anchor_level_permission: {
      InteractionQuestion: 0,
      beauty: 0,
      comment_filter: 0,
      comment_setting: 0,
      customizable_poll: 1,
      donation_sticker: 0,
      effects: 0,
      flip: 0,
      full_screen_mode: 0,
      hear_your_own_voice: 0,
      live_center: 0,
      live_intro: 0,
      mirror: 0,
      moderator_setting: 0,
      pause_live: 0,
      pictionary: 0,
      pin: 1,
      poll: 0,
      promote: 0,
      share: 1,
      sticker: 0,
      topic: 0,
      viewer_rank_list: 1,
      voice_effect: 0
    },
    transaction_history: 0,
    use_user_pv: false
  },
  stream_url: {
    candidate_resolution: [ 'SD1', 'SD2', 'HD1', 'FULL_HD1' ],
    complete_push_urls: [],
    default_resolution: 'FULL_HD1',
    extra: {
      anchor_interact_profile: 0,
      audience_interact_profile: 0,
      bframe_enable: false,
      bitrate_adapt_strategy: 0,
      bytevc1_enable: false,
      default_bitrate: 0,
      deprecated1: false,
      fps: 0,
      gop_sec: 0,
      hardware_encode: false,
      height: 0,
      max_bitrate: 0,
      min_bitrate: 0,
      roi: false,
      sw_roi: false,
      video_profile: 0,
      width: 0
    },
    flv_pull_url: {
      FULL_HD1: '',     
      HD1: '',
      SD1: '',
      SD2: ''
    },
    flv_pull_url_params: {
      FULL_HD1: '', 
      HD1: '',
      SD1: '',
      SD2: ''       
    },
    hls_pull_url: '',
    hls_pull_url_map: {},
    hls_pull_url_params: '',
    id: 0,
    id_str: '',
    live_core_sdk_data: { pull_data: [Object] },
    provider: 0,
    push_urls: [],
    resolution_name: {
      AUTO: 'AUTO',
      FULL_HD1: '1080p',
      HD1: '720p',
      ORIGION: 'Original',
      SD1: '360p',
      SD2: '540p',
      pm_mt_video_1080p60: '1080p60',
      pm_mt_video_720p60: '720p60'
    },
    rtmp_pull_url: '',       
    rtmp_pull_url_params: '',
    rtmp_push_url: '',
    rtmp_push_url_params: '',
    stream_control_type: 0,
    stream_delay_ms: 0,
    vr_type: 0
  },
  stats: {
    digg_count: 0,
    enter_count: 0,
    fan_ticket: 0,
    follow_count: 0,
    gift_uv_count: 0,
    id: ,
    id_str: '',
    like_count: 0,
    replay_fan_ticket: 0,
    replay_viewers: 0,
    share_count: 3,
    total_user: 34,
    total_user_desp: '',
    user_count_composition: { my_follow: 0.09, other: 0.88, video_detail: 0 },
    watermelon: 0
  },
  top_fans: [
    { fan_ticket: 1118, user: [Object] },
    { fan_ticket: 603, user: [Object] },
    { fan_ticket: 389, user: [Object] }
  ],
  title: "",
  viewers: 10,
  with_linkmic: true,
  share_url: '',
  short_title: '',
  room_id: '',
  anchor_id: '',
  extra: {
    digg_color: 15754271,
    finished_perception_msg: '',
    is_official_channel: false,
    pay_scores: 0
  }
}
const BASEURL = "https://kitkot.xyz/api";
const API_KEY = "my-api-key";
const session_key = "my-session-key";
const room_id = "someroomID"

const request = await fetch(`${BASEURL}/live/join?api_key=${API_KEY}&session_key=${session_key}&room_id=${room_id}`);
const response = await request.json();
console.log(response);

We suggest to always leave the live after you are done in it.

Last updated