Browse docs
Sprid docs

Connect Lemon Squeezy

Read sales and subscriptions from your Lemon Squeezy store.

Before you start

Access to your store’s Settings → API page.

Set it up

  1. Settings → API: click + and name the key Sprid.
  2. Save the key to a private file such as ~/keys/lemonsqueezy-sprid.txt. It is shown once.
  3. Settings → Stores: select your store and copy its numeric id from the page address.

Connect to Sprid

Run in your terminal
sprid connect lemonsqueezy --app <slug> --key ~/keys/lemonsqueezy-sprid.txt --store 12345

Use your Sprid app slug, your own file path and your store id. Both --key and --store are required.

Check the connection

Ask your agent: “Read this store’s Lemon Squeezy sales through Sprid and confirm the store is correct.” A saved key alone does not confirm access.

What the numbers mean

Revenue covers 28 complete calendar days: orders plus renewal and update invoices, without duplicate initial invoices, with refunds deducted on the original purchase date. Currencies stay separate. Incomplete pagination makes the total unavailable.

MRR stays unavailable until a complete priced billing schedule exists, because subscriptions carry price IDs, not prices.

If something goes wrong
  • Key rejected: create a replacement and reconnect.
  • Store not found: check the store id belongs to the account that created the key.
  • An unexpected error page appears: retry. If it persists, send the message to Sprid support.
Investigate with this connection

Reads orders, subscriptions and subscription-invoices for the pinned store. Product and variant filters separate apps in the same store.

Run in your terminal
sprid marketing-review capabilities --app <slug> --source lemonsqueezy --json

See connected queries.

Sources and verification

Prefer your terminal? sprid docs lemonsqueezy reads this same guide.

Need a hand?
Colour theme
Back to Sprid ↗