user_not_found: "API Error 19881007" and UserNotFoundError
TikTok-Live-Connector fails with "API Error 19881007 (user_not_found)" or "Failed to retrieve room_id from api-live", and TikTokLive (Python) raises UserNotFoundError: "The requested user ... is not capable of going LIVE on TikTok, or has never gone live on TikTok, or does not exist."
The error
API Error 19881007 (user_not_found)
Failed to retrieve room_id from api-live
# Python (TikTokLive)
UserNotFoundError: The requested user 'username' is not capable of going LIVE on TikTok, or has never gone live on TikTok, or does not exist.What it means
To connect, the library first turns the username into a room id. user_not_found means TikTok returned no user for that name.
Common causes: a typo in the username, an account that changed its handle, an account that has never gone LIVE, or a temporary problem with the lookup itself. In issue #323 the same error appeared for valid creators and the library maintainer reported that it was fixed.
A creator who exists but is offline gives a different error: "The requested user isn't online :(" (UserOfflineError).
Fix it in the library
- Open
https://www.tiktok.com/@usernamein a browser and copy the handle exactly as shown. - Confirm the creator is LIVE right now. Connect only when they are, or catch
UserOfflineErrorand retry later. - Update to the latest release (
npm install tiktok-live-connector@latestorpip install -U TikTokLive). If a creator who is clearly LIVE still returnsuser_not_found, check the issue tracker; issue #323 is the closed report for this error.
Or use the hosted API
With the TikTools SDK, connect() rejects with a plain message when the creator is offline or the handle does not exist, so one catch covers both cases. This is the script and the output from the run on 2026-10-31:
npm install @tiktool/liveconst { TikTokLive } = require('@tiktool/live');
const connection = new TikTokLive({
uniqueId: process.argv[2] || 'username',
apiKey: process.env.TIKTOOL_API_KEY || 'YOUR_API_KEY',
});
connection.on('connected', () => console.log(`Connected to roomId ${connection.roomId}`));
connection.on('error', err => console.error('error event:', err.message || err));
connection.connect()
.then(() => setTimeout(() => connection.disconnect(), 5000))
.catch(err => console.error('Failed to connect:', err.message));Output
$ node offline-check.js zzqq_no_such_user_8812733
Failed to connect: User @zzqq_no_such_user_8812733 is not currently live
$ node offline-check.js tiktok
Failed to connect: User @tiktok is not currently live Python: pip install tiktok-live-api. Side-by-side code for both languages and the full event name map are in the migration guide. Plans and connection limits are on the pricing page; Sandbox is a 7-day evaluation, no credit card.