Use your agent · 3 min

Use the ScrollShow API

Your own code can use ScrollShow too: read what it found in your Library and make slideshows, the same things your agent does. One key, one kind of call.

Get a key

Open Settings › Agents and find Keys for scripts.
Press New key and copy it. It shows only once.

The API comes with the monthly plans. Agents don't need a key: connect them in Settings › Agents.

Make a call

Every call is a POST to one tool, with its arguments as JSON and your key in the header:

curl -X POST https://scroll.show/api/v1/tools/library_posts \
  -H "Authorization: Bearer ss_live_..." \
  -H "Content-Type: application/json" \
  -d '{"sort": "views", "min_slides": 5}'

The answer is { ok, tool, text, data }: text is a short summary, data the same as JSON. GET https://scroll.show/api/v1/tools lists every tool with its arguments.

Three things to try

Read your Library

library_posts gives the posts ScrollShow found in your open workspace, with their views, likes and saves. post_slides gives one post's slides, and download_posts adds posts by their TikTok links.

POST /api/v1/tools/library_posts
{"sort": "views", "recent_days": 30}

Make a slideshow

create_slideshow starts one and gives back its id. build_slides fills every slide in one call: a layout, the words and the photo.

POST /api/v1/tools/create_slideshow
{"title": "5 dinners for nights you can't be bothered"}

POST /api/v1/tools/build_slides
{"slideshow_id": "...", "slides": [{"slide": 1,
  "layout": {"kind": "photo", "photo": {"url": "https://..."},
  "title": "5 dinners for nights you can't be bothered"}}]}

Get the slides as pictures

Each slide comes as a PNG at its export size (1080 × 1920 for 9:16), ready for TikTok. Add ?format=jpeg for a JPG.

curl https://scroll.show/api/v1/slideshows/{id}/slides/1 \
  -H "Authorization: Bearer ss_live_..." -o slide-1.png

What's in it

Workspaces: status, niches, switch_niche. Everything reads from the workspace you have open.
Library: library_accounts, library_posts, post_slides, collections, save_to_collection, download_posts.
Make: create_slideshow, build_slides, list_slideshows, get_slideshow, and tools to edit text, pictures, shapes and slides.
Pictures: search_images, generate_image (one image credit), remove_background, upscale_image.
Check your work: render_slide, render_slideshow.

Finding new accounts and posts on TikTok isn't in the API: it runs on your computer, from ScrollShow or your agent. Everything it finds is here to read.

When something fails

401 unauthorized: the key is missing or wrong.
402 plan_required: the API comes with the monthly plans.
400 invalid_arguments: an argument is wrong; issues says which.
429 rate_limited: too many calls at once. Wait a moment and try again.

The whole API as OpenAPI 3.1: scroll.show/api/v1/openapi.json. Hand it to your agent or your tool and it knows every call.