MeowLoad Docs
On this page

Check Remaining Credits API

Returns the remaining credits of the account that owns the API key. All keys belonging to the same user share this balance, so any valid key returns the same balance. 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 an extraction endpoint 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.
  • API credits are a separate API billing balance. The cost depends on the endpoint; credits are not a count of successful calls and are separate from website and desktop memberships and AI credits.

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, create and manage up to 5 API keys, and set the phone number that receives balance alert SMS. To replace a key, create a new one, switch your business to it, then delete the old key.

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