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/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E6%A0%87%E9%A2%98.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=9f8a53e551693b954194e176eadb617a

Title

title
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E6%96%87%E5%AD%97%E6%AE%B5.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=4cf36413a73acc0068b8487823592976

Text block

text
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E5%9B%BE%E7%89%87.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=73ddc445d445494414bb3892417b1875

Figure

figure
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E5%9B%BE%E4%BE%8B.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=f06418f6495a58c0c5fa6fecf0679748

Figure caption

figure_caption
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E8%A1%A8%E6%A0%BC.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=e3079c324e45dae0d223a7e390753b14

Table

table
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E8%A1%A8%E4%BE%8B.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=f927e7f04c1571bcabb15fa83156ec96

Table caption

table_caption
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E5%85%AC%E5%BC%8F.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=2f76a543d6710bcc4665512268f222f8

Equation

equation
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E9%A1%B5%E7%9C%89.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=dcddb88a7b2ed21f3b2735800175f090

Header

header
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E9%A1%B5%E8%84%9A.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=225add72be26b3fc9e42272f100cead9

Footer

footer
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E4%BE%A7%E8%BE%B9%E6%A0%8F.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=1a31efcbbdc229996ed8502d18a96a73

Sidebar

sider
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E8%84%9A%E6%B3%A8.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=fe78efb097fe7885865c9e24fdcab2de

Footnote

footnote
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E7%9B%AE%E5%BD%95.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=7e7939f79f4fb23c1071403baf6f31df

Table of contents

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

TOC entry

cate_item
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E9%80%89%E9%A1%B9.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=657ec593723f803e43e3637ea821e1b8

Choice item

choice
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E4%BB%A3%E7%A0%81%E6%AE%B5.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=48574c42391c2117bce29ee62e0a099f

Code block

code
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E5%A1%AB%E7%A9%BA%E7%A9%BA%E7%99%BD.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=0b5e31383fa659098fad9539a76a49e1

Fill-in-the-blank

blank
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=757bf1aac35041ed83899c850045c8f9

Reference

reference
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E4%BA%8C%E7%BB%B4%E7%A0%81.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=ab5f1acb8cbc1bcaa8e69bf9711a0e25

QR code

qrcode
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E5%8D%B0%E7%AB%A0.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=866c073e09c95f03f7215126d8cf025e

Stamp

stamp
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E5%8C%96%E5%AD%A6%E7%BB%93%E6%9E%84%E5%BC%8F.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=1c90a25d538bfc8d44dc9744b5490a20

Chemical structure

cs
https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E5%8C%96%E5%AD%A6%E6%96%B9%E7%A8%8B%E5%BC%8F.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=6e181921c9cf0375b93b360360ee90b1

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.