Skip to content

DocsStart here

Getting started with OpenPromo

Get started with OpenPromo: add your YepAPI key, set a spending limit, add your website, check the brand profile and make your first post or reel.

This guide covers the hosted app. To run OpenPromo on your own machine instead, see Self-hosting; the steps after installing are the same.

OpenPromo is open-source software and charges nothing. The AI work (reading your website, writing, voices, music and AI pictures) runs on your own YepAPI key, and YepAPI bills each call to it. A monthly limit in Settings caps what you spend.

  1. Create a YepAPI account

    Sign up at yepapi.com and get $5 in free credit, for a limited time. Then copy your API key from the YepAPI dashboard.

  2. Create an OpenPromo account

    Sign up for OpenPromo. The account is free.

  3. Add your key and a spending limit

    Open Settings, paste your YepAPI key and save. OpenPromo checks the key and stores it encrypted. Set a monthly spending limit on the same page: any call whose price would cross it is refused.

  4. Add your website

    Create a project with your website address. OpenPromo opens a handful of pages in headless Chrome, takes screenshots and builds your brand profile. It takes about a minute and costs about $0.05 to $0.15.

  5. Check the brand profile

    Read what OpenPromo found: what you do, who it is for, your voice and selling points, each with the sentence and page it came from, plus colors, fonts, logo and products. Fix anything that is wrong. Your edits are kept when the site is read again.

  6. Make your first post or reel

    Open Ideas and write a batch of post ideas, or start from a short brief. Click Make it on an idea, check the warnings, edit the text with the live preview, then render. Images cost nothing to render unless they use an AI picture; a 30-second reel is usually $0.15 to $0.50.

The OpenPromo brand profile for Crumb & Co: name, tagline, description, selling points with the sentence each came from, brand colors, logo and fonts
The brand profile OpenPromo built from a website: selling points with their source, colors, logo and fonts.
The OpenPromo editor showing a five-slide Instagram carousel for Crumb & Co with a live preview, the rendered slides and the slide settings
The editor: slides on the left, a live preview in the brand’s fonts, every field on the right.

Next steps after setup