SoMark SDK

Best for products, backend services, and automation systems. If you are still comparing integration paths, start with the get started overview; if you only need a terminal workflow, go to SoMark CLI.

Install the SDK

SoMark provides both Python and JavaScript implementations.

pip install somark

npm install somark-js

Initialize the client

The simplest setup is to pass your API key during initialization.

from somark import SoMark

client = SoMark(api_key="sk-your-api-key")

import { SoMark } from 'somark-js'

const client = new SoMark({ apiKey: 'sk-your-api-key' })

Complete one sync parse first

Start with one file and one working result before expanding into more formats or downstream processing.

response = client.parser.parse(
    file="./document.pdf",
    formats=["md", "json"],
)
response.save("./document.md")

const response = await client.parser.parse({
  file: './document.pdf',
  formats: ['md', 'json'],
})

await response.save('./document.md')

Use async tasks for larger jobs

Long documents, batch jobs, and background flows are a better fit for async mode.

task = client.parser.parse_async(file="./large.pdf", formats=["md"])
result = task.wait()
result.save("./large.md")

const task = await client.parser.parseAsync({
  file: './large.pdf',
  formats: ['md'],
})

const result = await task.wait()
await result.save('./large.md')

For more parameter details and error-handling guidance, continue to the CLI & SDK usage guide.

SoMark CLI SoMark Skill

Overview

Quickstart

Ecosystem

FAQs