Retrieve all accounts

October 7, 2026 (October 22, 2026)

Table of contents

  1. Request Headers
  2. Responses
  3. Model
  4. Examples
  5. Try It

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, 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}
Responses

  • 200 OK

    {
  "[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
    },
    "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
    },
    "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.
    • health is OK, verifying while 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.
    • exhaustedUntil appears when Google refused a job because the account’s monthly video seconds (video) or images (image) were used up. Until that time, Google’s reset time, the account gets no jobs of that kind: jobs without email go to your other accounts, and a request that must run on this account gets 429 with retryAt. It is shown only while in force. GET /accounts/email removes 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.

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "useapi.net ⁝ Unauthorized",
  "code": 401
}
Model 
{ // 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)
    }
    avatarsOnly?: true              // 0 video and 0 images (e.g. a free Google account): avatars only
    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
    }
    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())
Try It