ReelspanUpload guidesLemmy

Post to Lemmy automatically

Connect Lemmy once, then send videos, photos and text posts to it from code, a workflow or an AI agent. The same call can post to every other network at the same time.
1 min setup10,000 characters16:91:17 sections

01

Connect Lemmy

  1. Use an account on your Lemmy server that may post in the community.
  2. In the dashboard, enter the server, the community and the login.
  3. Reelspan signs in once to get a token; your password isn’t kept.

Posting for clients? Send them a connect link so they connect their own Lemmy account without a Reelspan login.

02

Get an API key

In the dashboard, open Developers → API keys and create one. Keep it in an environment variable such as REELSPAN_KEY; never in code you share.

03

Post with one request

Send the video as a file, or as a public URL like below. Add more platform[] fields to post the same thing everywhere at once.

curl
curl -X POST https://api.reelspan.com/v1/posts/video \
  -H "Authorization: Bearer $REELSPAN_KEY" \
  -F user=my-brand \
  -F "platform[]=lemmy" \
  -F "video=https://example.com/clip.mp4" \
  -F "title=Your body" \
  -F "lemmy_description=…"
JavaScript (Node 18+)
const form = new FormData();
form.append('user', 'my-brand');
form.append('platform[]', 'lemmy');
form.append('video', 'https://example.com/clip.mp4');
form.append('title', 'Your body');

const res = await fetch('https://api.reelspan.com/v1/posts/video', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.REELSPAN_KEY}` },
  body: form,
});
console.log(await res.json());
Python
import os, requests

res = requests.post(
    "https://api.reelspan.com/v1/posts/video",
    headers={"Authorization": f"Bearer {os.environ['REELSPAN_KEY']}"},
    files=[
        ("user", (None, "my-brand")),
        ("platform[]", (None, "lemmy")),
        ("video", (None, "https://example.com/clip.mp4")),
        ("title", (None, "Your body")),
    ],
)
print(res.json())

lemmy_title sets Lemmy’s title (up to 200 characters), separate from the text.

04

Lemmy options

lemmy_title
The post title, up to 200 characters.
lemmy_description
The body.
  • Any Lemmy server and community you can post in.
  • One image or video per post.

Every field, with its limits: the docs.

05

Schedule it and check the result

  • Add scheduled_date (ISO 8601) and timezone to post later, or add_to_queue=true to take the next slot of your posting schedule.
  • The response has Lemmy’s status and the post’s link. For big files send async_upload=true and check GET /v1/posts/status?request_id=…, or get a signed webhook when it’s live.
  • If Lemmy refuses a post, the error says why in plain words, and you can retry just that network.

06

Without code

07

Ideas

  • Share clips and articles with your Lemmy community.

More on Lemmy: what you can post there. Other networks: all upload guides.

Questions?Talk to a person.Contact us