01
Connect Lemmy
- Use an account on your Lemmy server that may post in the community.
- In the dashboard, enter the server, the community and the login.
- 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 -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=…"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());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) andtimezoneto post later, oradd_to_queue=trueto 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=trueand checkGET /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.