Skip to main content

​
Base URL

https://somark.tech/api/v1

​
Authentication

All requests pass the API key via the api_key field in the request body in sk-*** format. 
# multipart/form-data example
-F "api_key=sk-your-api-key"

​
Endpoints

EndpointMethodPathDescription
Sync parsingPOST/parse/syncUpload a file and receive results immediately
Async parsingPOST/parse/async + /parse/async_checkSubmit a task and poll results using task_id
Usage QueryPOST/usageCheck remaining quota and account information for the current API key
Path migration notice: All parsing endpoint paths have been changed from /extract/ to /parse/. The old paths (/extract/acc_sync, /extract/async, /extract/async_check) will be discontinued on December 31, 2026. Please migrate to the new paths before then.

​
Usage Limits

File Size

Maximum 200MB per file

Page Limit

Maximum 300 pages per request

Rate Limit

Beta: QPS 1 per account

​
Supported File Formats

pdf png jpg jpeg bmp tiff jp2 dib ppm pgm pbm gif heic heif webp xpm tga dds xbm doc docx ppt pptx

​
Recognized Document Elements

https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E6%A0%87%E9%A2%98.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=e3e4fc73a7465bf0c6451dc3a0338095

Title

title
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E6%96%87%E5%AD%97%E6%AE%B5.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=12299c6659cfb8c3b959f3b674448caf

Text block

text
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%9B%BE%E7%89%87.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=0855fb1d50ef6f311b821a3a211fad42

Figure

figure
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%9B%BE%E4%BE%8B.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=1df4efbb7cedfaa28f52bed0a27bb750

Figure caption

figure_caption
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E8%A1%A8%E6%A0%BC.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=d8cf3f723e865ac5e800ac5d607f2ef7

Table

table
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E8%A1%A8%E4%BE%8B.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=55399e36e6299e2eb3ec14123d06e8b0

Table caption

table_caption
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%85%AC%E5%BC%8F.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=67f3b05a7dd82641f97f1f6617a87e2a

Equation

equation
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E9%A1%B5%E7%9C%89.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=a5b06d360c0dab4375067bd41b5f85ab

Header

header
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E9%A1%B5%E8%84%9A.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=a9c1f47f6a5012fc4f74e3975eba6c08

Footer

footer
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E4%BE%A7%E8%BE%B9%E6%A0%8F.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=b275a97fc233d74422ad64f0b785f895

Sidebar

sider
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E8%84%9A%E6%B3%A8.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=d6432c312a7606eac70b78275434066a

Footnote

footnote
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E7%9B%AE%E5%BD%95.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=bdddd0c059370efacffb2aaa9a0e09aa

Table of contents

cate
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E7%9B%AE%E5%BD%95%E6%9D%A1%E7%9B%AE.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=9ed56458871e3ca1feeeee72470d5409

TOC entry

cate_item
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E9%80%89%E9%A1%B9.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=edf4fbbadda32e3266c465dcede7f24c

Choice item

choice
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E4%BB%A3%E7%A0%81%E6%AE%B5.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=64bf2e0b11ef8bd52569f7ee0a9ff959

Code block

code
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%A1%AB%E7%A9%BA%E7%A9%BA%E7%99%BD.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=f288a777c1077d4a3a8433b06a2ff021

Fill-in-the-blank

blank
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=000002e0c48dc1f7df9869dd3979e4df

Reference

reference
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E4%BA%8C%E7%BB%B4%E7%A0%81.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=1264055d3c4053bdf03be668ee532e75

QR code

qrcode
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%8D%B0%E7%AB%A0.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=74981c5e8a7e0511c54100e7a9a5a1b2

Stamp

stamp
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%8C%96%E5%AD%A6%E7%BB%93%E6%9E%84%E5%BC%8F.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=7a822a52b2bfd50fa8f3943559b4cdb7

Chemical structure

cs
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%8C%96%E5%AD%A6%E6%96%B9%E7%A8%8B%E5%BC%8F.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=63fd0b8e80f48077dc5ef1d21739ceeb

Chemical equation

cs_equation

​
Error Codes

All endpoints return a unified code field. A non-zero value indicates an error. See the full Error Codes reference.