Your whole collection. Every pixel.

cURL

# 1 · Convert an image from a URL
curl --location --get https://api.zoomhub.net/v1/content \
  --data-urlencode "url=https://example.org/scan.tif" \
  --data-urlencode "email=you@example.org"

# 2 · Follow the link I email you, then poll until "ready"
curl https://api.zoomhub.net/v1/content/k7Hq

# Or upload a file with an API key (Business plan)
curl --header "Authorization: Bearer $ZOOMHUB_API_KEY" \
  "https://api.zoomhub.net/v1/content/upload?contentType=image%2Fjpeg&filename=scan.jpg" > form.json
fields=(); while IFS= read -r field; do fields+=(--form-string "$field"); done \
  < <(jq --raw-output 'del(.url, ."Content-Type") | to_entries[] | "\(.key)=\(.value)"' form.json)
curl "${fields[@]}" --form-string "Content-Type=image/jpeg" --form "file=@scan.jpg" \
  "$(jq --raw-output .url form.json)"
curl --location --header "Authorization: Bearer $ZOOMHUB_API_KEY" \
  "https://api.zoomhub.net/v1/content?url=$(jq --raw-output '.url + "/" + .key | @uri' form.json)"

JavaScript

const api = "https://api.zoomhub.net"

// 1 · Convert an image from a URL
const query = new URLSearchParams({ url: "https://example.org/scan.tif", email: "you@example.org" })
let content = await (await fetch(`${api}/v1/content?${query}`)).json()

// 2 · Follow the link I email you, then poll until it’s ready
while (!content.ready && !content.failed) {
  await new Promise((resolve) => setTimeout(resolve, 5000))
  content = await (await fetch(`${api}/v1/content/${content.id}`)).json()
}

// 3 · Share it, or paste content.embedHtml into your page
console.log(content.shareUrl)

// Or upload a file with an API key (Business plan)
const headers = { Authorization: `Bearer ${apiKey}` }
const params = new URLSearchParams({ contentType: file.type, filename: file.name })
const { url, ...fields } = await (await fetch(`${api}/v1/content/upload?${params}`, { headers })).json()
const body = new FormData()
for (const [name, value] of Object.entries(fields)) body.append(name, value)
body.set("Content-Type", file.type)
body.append("file", file) // the file goes last
await fetch(url, { method: "POST", body })
const uploaded = new URLSearchParams({ url: `${url}/${fields.key}` })
content = await (await fetch(`${api}/v1/content?${uploaded}`, { headers })).json()

Python

import time
import requests

api = "https://api.zoomhub.net"

# 1 · Convert an image from a URL
content = requests.get(f"{api}/v1/content",
    params={"url": "https://example.org/scan.tif", "email": "you@example.org"}).json()

# 2 · Follow the link I email you, then poll until it’s ready
while not (content["ready"] or content["failed"]):
    time.sleep(5)
    content = requests.get(f"{api}/v1/content/{content['id']}").json()

# 3 · Share it, or paste content["embedHtml"] into your page
print(content["shareUrl"])

# Or upload a file with an API key (Business plan)
headers = {"Authorization": f"Bearer {api_key}"}
form = requests.get(f"{api}/v1/content/upload", headers=headers,
    params={"contentType": "image/jpeg", "filename": "scan.jpg"}).json()
url = form.pop("url")
form["Content-Type"] = "image/jpeg"
with open("scan.jpg", "rb") as file:
    requests.post(url, data=form, files={"file": file}).raise_for_status()
content = requests.get(f"{api}/v1/content", headers=headers,
    params={"url": f"{url}/{form['key']}"}).json()