Reimply API
Ingest API: PDF, Word and data to Markdown
Turn a digital PDF, Word document, CSV, TSV or JSON file into clean Markdown, tables as JSON where they can be found, and chunks of about 512 tokens, ready to feed an AI tool. Files are processed in memory, not written to disk. Ingest does not run OCR: scanned or image-only PDFs return 422 ocr_required_unsupported and are not charged. Available on Growth and Scale.
Example
Endpoint POST /v1/ingest. Options used here: chunk_size.
curl https://reimply.com/v1/ingest \
-H "Authorization: Bearer $REIMPLY_API_KEY" \
-F "file=@report.pdf" \
-F 'options={"chunk_size":512}'
# The JSON reply lists one signed download URL per file in "outputs".import { readFile, writeFile } from 'node:fs/promises'
const form = new FormData()
form.append('file', new Blob([await readFile('report.pdf')]), 'report.pdf')
form.append('options', JSON.stringify({"chunk_size":512}))
const res = await fetch('https://reimply.com/v1/ingest', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.REIMPLY_API_KEY}` },
body: form,
})
const job = await res.json()
if (!res.ok) throw new Error(job.error.message)
for (const o of job.outputs) {
const file = await fetch(o.url)
await writeFile(o.name, Buffer.from(await file.arrayBuffer()))
}
console.log(job.id, 'used', job.credits.charged, 'credit(s)')import os, requests
with open("report.pdf", "rb") as f:
res = requests.post(
"https://reimply.com/v1/ingest",
headers={"Authorization": f"Bearer {os.environ['REIMPLY_API_KEY']}"},
files={"file": f},
data={"options": '{"chunk_size":512}'},
)
job = res.json()
res.raise_for_status()
for o in job["outputs"]:
with open(o["name"], "wb") as out:
out.write(requests.get(o["url"]).content)
print(job["id"], "used", job["credits"]["charged"], "credit(s)")The reply is a job object with one signed download link per output file.
Use cases
- Prepare documents for retrieval and chat tools
- Turn spreadsheets into Markdown tables
- Chunk Word drafts for an AI pipeline
Pricing
This job uses 1 conversion and is available on Growth and Scale. Free accounts get 250 conversions a month, and paid plans start at £12 a month for 3,000. Pricing.
Questions
How many conversions does a Ingest job use?
One conversion per file, whatever the size. Video and audio jobs use 3. Failed jobs are free.
Which plans include ingest?
Growth (£39 a month) and Scale. Free and Starter accounts get 403 plan_upgrade_required, with an upgrade link, and are not charged.
Do you run OCR on scanned PDFs?
Not in this version. If the PDF has no extractable text, or under about 20 characters per page on average, you get 422 ocr_required_unsupported and nothing is charged.
How do I get several output files?
The JSON reply has one entry in "outputs" per file, each with a signed download URL that works for 60 minutes.
Can I try it for free?
Yes. Every account gets 250 free conversions a month, no card needed. Create a key in your account and run the sample above.
What happens to my files?
Ingest runs in memory and is not written to disk during processing. Uploaded files and results are deleted automatically 60 minutes after the job.
Just need to do this once? Use the free Ingest tool on reimply.com.