Open API - Media Parsing Documentation

01 · Quickstart

Send a parsing request

Add your API key to the request header and submit one public media URL in the JSON body.

curl -X POST https://api.videotool.cc/openapi/parse \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://..."}'

02 · Authentication

Authenticate with an API key

Send X-API-Key with each request. View or rotate the key in the API console.

X-API-KeyYOUR_API_KEY

Keep API keys on your server. Never place one in browser JavaScript, a mobile binary, or a public repository.

03 · Endpoint

Available endpoint

POST/openapi/parseSingle URL

Parse one public media URL

Submit one public post or video URL. One credit is charged after usable resources are returned.

url string · required Public post or video URL

04 · Response

Successful response

A successful call returns ParseResult in the standard AjaxResult wrapper, grouped into video, image, audio, and text resources.

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "resultCode": 0,
    "hasResource": true,
    "resourceType": 200,
    "descList": ["..."],
    "imgList": [],
    "videoList": [],
    "audioList": []
  }
}

05 · Errors

Business error codes

code	Meaning	Charge
`400`	Missing or invalid URL	Not charged
`401`	Missing, invalid, or disabled API key	Not charged
`403`	Insufficient credits	Not charged
`422`	No usable resource was returned	Not charged
`500`	Parsing service error	Not charged

06 · Billing

Charge successful results only

1credit charged when usable resources are returned

0credits charged for failures, errors, or empty results

Current scope

The Open API exposes only POST /openapi/parse for one URL. Batch, capabilities, idempotency cache, and rate-limit endpoints are not provided.

Add media parsing with one endpoint