Retrieve all accounts
October 7, 2026 (November 16, 2026)
Table of contents
List the Google accounts connected with POST /accounts. Each entry shows the account’s health, its maxJobs, the monthly limits Google reported when it was added (an account added before November 4, 2026 shows its speech and avatarVideo limits after its next GET /accounts/email), and exhaustedUntil while the account sits out a kind of job because its allowance is used up.
This endpoint does not call Google. For the live session and what is left of each allowance use GET /accounts/email. GET /jobs shows how many jobs each account is running.
https://api.useapi.net/v1/google-vids/accounts
Request Headers
Authorization: Bearer {API token}
API tokenis required, see Setup useapi.net for details.
Responses
-
{ "[email protected]": { "email": "[email protected]", "maxJobs": 3, "added": "2026-10-07T02:21:08.626Z", "updated": "2026-10-07T05:47:38.929Z", "cookies": [ "SID", "HSID", "SSID", "APISID", "SAPISID", "__Secure-1PSIDTS", "OSID" ], "cookiesExpireAt": "2027-04-05T02:18:00.438Z", "vidsDocId": "1N48K72jE4hpv4A3XPH3rf0EVTpMCERAwf4uDmQPc6v4", "limits": { "video": 10000, "image": 1000, "music": 300, "speech": 50, "avatarVideo": 10 }, "health": "OK", "exhaustedUntil": { "video": "2026-11-01T07:00:00.000Z" } }, "[email protected]": { "email": "[email protected]", "maxJobs": 3, "added": "2026-10-07T01:07:47.890Z", "cookies": [ "SID", "HSID", "SSID", "APISID", "SAPISID", "__Secure-1PSIDTS", "OSID" ], "cookiesExpireAt": "2027-04-05T01:05:12.204Z", "vidsDocId": "1zeizDjTAw4DyXjNZKPkHuAhHJt87J6COR_Hc4L3gKJw", "limits": { "video": 10000, "image": 1000, "music": 300, "speech": 50, "avatarVideo": 10 }, "health": "Google signed this account out. Re-add it at https://useapi.net/docs/start-here/setup-google-vids" } }- The response is an object keyed by account email, or
{}when no account is connected. healthisOK,verifyingwhile the API re-checks an account Google reported as signed out, or the reason the account must be re-added. A paused account takes no new jobs until you re-add it with POST /accounts.exhaustedUntilappears when Google refused a job because the account’s monthly video seconds (video), images (image), Gemini uses (speech) or AI avatar videos (avatarVideo) were used up. Until that time, Google’s reset time, the account gets no jobs of that kind: jobs withoutemailgo to your other accounts, and a request that must run on this account gets429withretryAt. It is shown only while in force. GET /accounts/emailremoves it early when Google shows allowance left again, for example after a plan upgrade, and a re-add with POST /accounts clears it. Uploads and avatars are never held back by it.
- The response is an object keyed by account email, or
-
Invalid API token.
{ "error": "useapi.net ⁝ Unauthorized", "code": 401 }
Model
An object keyed by account email, each with its health, maxJobs, monthly limits and any exhaustedUntil reset times.
Every account record, keyed by email, field by field
{ // TypeScript, all fields are optional
[email: string]: {
email: string
maxJobs: number // jobs this account may run at the same time
added: string // ISO 8601, when the account was first connected
updated?: string // ISO 8601, the last re-add or maxJobs change
cookies: string[] // names of the stored cookies, never their values
cookiesExpireAt?: string | null // ISO 8601, the earliest expiry date in the pasted cookies
vidsDocId: string // the Google Vids document the API created on the account
limits: { // monthly limits, read from Google on add and kept current by GET /accounts/{email}
video: number | null // seconds of video
image: number | null // images
music: number | null // songs (not used by this API)
speech?: number | null // Gemini uses: POST /speech, and the speech of each talking avatar video
avatarVideo?: number | null // AI avatar videos (POST /videos/avatar)
}
avatarsOnly?: true // 0 video and 0 images (e.g. a free Google account): no clips or images, only avatars, speech and avatar videos
health: string // 'OK', 'verifying', or the reason the account must be re-added
exhaustedUntil?: { // job types this account sits out, only while in force (a re-add clears it)
video?: string // ISO 8601, Google's reset time for the used-up video seconds
image?: string // ISO 8601, Google's reset time for the used-up images
speech?: string // ISO 8601, Google's reset time for the used-up Gemini uses
avatarVideo?: string // ISO 8601, Google's reset time for the used-up AI avatar videos
}
addedVia?: 'setup-browser' // present when the account was added by the automated setup
}
}
Examples
-
curl "https://api.useapi.net/v1/google-vids/accounts" \ -H "Authorization: Bearer …" -
const token = "API token"; const apiUrl = "https://api.useapi.net/v1/google-vids/accounts"; const response = await fetch(apiUrl, { headers: { "Authorization": `Bearer ${token}`, }, }); const result = await response.json(); console.log("response", {response, result}); -
import requests token = "API token" apiUrl = "https://api.useapi.net/v1/google-vids/accounts" headers = { "Authorization" : f"Bearer {token}" } response = requests.get(apiUrl, headers=headers) print(response, response.json())