# Reel Reviews agent guide

## How to turn a Google review into a video (for AI agents)

Build this URL, URL-encoding each value, and open it with a GET request:

    https://spike.reelreviews.net/google-review-to-video?text={review text}&author={reviewer name}&rating={1-5}&business={business name}

Optional parameters: `source_url` (link to the original review), `theme` (`light` or `dark`).

The request saves a draft and redirects (303) to the draft page, `https://spike.reelreviews.net/d/{id}`. Give that URL to the user. The same input always gives the same draft id, so retrying is safe.

Rules:
- Copy the review text word for word. Never paraphrase, improve, translate or invent a review.
- `text`, `author`, `rating` and `business` are required. If the user hasn't given one, ask them; don't guess.
- Google reviews are already public, and the business is sharing its own review. Send the reviewer's name as written: on screen it is always shortened to first name and last initial (Megan Doyle becomes "Megan D.").
- Send the whole review, however long (up to 2,000 characters). Don't shorten it: long reviews are shortened on screen automatically, with a visible "…".

Checking your work:
- `https://spike.reelreviews.net/d/{id}.md` or `.json` returns the draft as text or data.
- `https://spike.reelreviews.net/d/{id}/sheet.png` is one image with four key frames of the video. Look at it to check the result.
- If a parameter is wrong you get a 400 explaining exactly what to fix, with a corrected URL to try.

Everything is GET. There is no account and nothing to pay at this step. Exporting an MP4 is a paid step the business owner does from the draft page.
