# Quickstart

PostReef is an API for turning any social-media video into structured data. Submit a URL and get back the video, its metadata, a transcript, the comments, plus an optional typed JSON extraction produced by our AI engine against a schema you provide. One URL in, clean data out.

## Build with the API

The API is the product. Three calls (quote, submit, collect) and you have structured data in your own code.

1. **Sign up.** [Create an account](/signup), then top up. Your first top-up earns **1,000 bonus credits** on top of the credits you buy.
2. **Grab an API key.** Create one in the dashboard and send it on every request.
3. **Submit, wait, collect.** `POST /v1/extractions` with a URL, your inputs and an optional JSON Schema; poll the result or register a webhook. Full walkthrough in the [API quickstart](/docs/api/quickstart) and [API overview](/docs/api).

```bash
curl https://postreef.com/v1/extractions \
  -H "x-api-key: $VIDEXTRACT_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "url": "https://www.youtube.com/watch?v=...", "inputs": ["transcript", "comments"] }'
```

## Try it in the web app first

Want to see what a video yields before writing any code? The [home page](/) runs the same pipeline from your browser: paste a URL, pick inputs, see a live credit quote, run it, and download the results. It's the fastest way to explore schemas and sanity-check a video. Everything it does maps one-to-one onto an API call, and runs you create there share the same account and credit balance.

## Supported platforms

PostReef works with **YouTube** (including Shorts), **TikTok**, **Instagram Reels** and many more video platforms. If the video is publicly accessible, chances are we can extract it. Submit the URL (or paste it in the web app) and the probe tells you right away what's available.

## Where to next

Start with the [API overview](/docs/api) and [API quickstart](/docs/api/quickstart). For the data model, read [what you can extract](/docs/extractions), how [pricing](/docs/pricing) works, and [writing a custom schema](/docs/schemas).
