Developer docs

PostCapture API

Generate shareable screenshots of social media posts programmatically, across X, YouTube, TikTok and Bluesky.

Quick start

  1. 1

    Get a key

    Start an API subscription from the API pricing section to activate access automatically. Then create your own keys in the dashboard; they're prefixed with sk_.

  2. 2

    Make a request

    POST the post URL to the v1 endpoint with your key in the Authorization header. Everything else is optional.

    1curl -X POST https://postcapture.com/api/v1/screenshot \
    2 -H "Authorization: Bearer $POSTCAPTURE_API_KEY" \
    3 -H "Content-Type: application/json" \
    4 -d '{
    5 "postUrl": "https://x.com/postcaboron/status/1924847327370461555"
    6 }'
  3. 3

    Get your screenshot

    You get back JSON with a url to the PNG, its dimensions and your remaining quota. The URL is valid for at least an hour and the image is deleted shortly after, so download it if you need it for longer. Prefer the raw bytes? Add "response": "image" to the body.

Explore the docs

Base URL

https://postcapture.com

All API endpoints are relative to this base URL. Each successful request uses one screenshot from your monthly quota.