MeowLoad Docs
On this page

Check Remaining Credits API

Returns the remaining credits of the account that owns the API key. Checking is free, so you can poll it for usage monitoring and custom balance alerts. The system also emails and texts you by default when the balance drops below 10,000, 2,000, 300 and 100, and when it reaches 0.

🎯 Basic Information

ItemDetails
Endpointhttps://api.meowload.net/openapi/v1/credits
MethodGET
AuthenticationAuthorization: Bearer <your API key> header, with a key from the Developer Console
BillingFree, no credits are deducted

New to the API? Start with the Quickstart.

📋 Request Parameters

There is no request body. Error messages are in English by default; send an Accept-Language header (for example zh or ja) to localize them.

Request Example

curl https://api.meowload.net/openapi/v1/credits \
  -H "Authorization: Bearer <your API key>"

🟢 Success Response

Response Example

A successful call returns HTTP 200:

{ "availableCredits": 282539 }

Response Field Descriptions

  • availableCredits is the remaining credit count, an integer. Every successful call to one of the three extraction endpoints deducts from it immediately; how much depends on the endpoint and the platform, as listed in the Developer Console.
  • For usage monitoring, polling once a minute is plenty; there is no need to check before every extraction.

The full definition is in the API reference.

🔴 Error Response

The body shape and handling of 401 (invalid API key) and 429 (rate limited) are covered in Error Codes.

💳 Top Up and Management

In the Developer Console you can top up credits, check your balance and the billing rules, reset your API key, and set the phone number that receives balance alert SMS.

The system sends an email and SMS alert automatically when the balance reaches each of these points:

  • Below 10,000
  • Below 2,000
  • Below 300
  • Below 100
  • Zero