Start here (beta testers)
ListrApp is invite-only during beta. You will get a link and invite code from the team. You do not need API keys or an eBay Developer account—only your normal eBay seller account.
- Open the ListrApp link you were sent.
- Sign in and enter your invite code.
- Click Connect to eBay in the sidebar and approve access.
- Add photos → Generate listing → review → publish.
During beta you publish to your own live eBay account. Your listings and connection are private to your login—not shared with other testers.
What you need
- Invite code – from the ListrApp team.
- eBay seller account – the account you list from.
- Photos – up to 20 per item (JPG, PNG, GIF, WebP).
- eBay business policies – payment, return, and shipping (one-time IDs; see below).
AI listing generation is included. You never enter an Anthropic or developer key.
Connect your eBay account
- In the sidebar, click Connect to eBay.
- Sign in with your eBay seller account.
- Click Agree and Continue / Approve.
- The sidebar should show eBay: Connected.
Important: Always use the same ListrApp URL you were invited to (do not switch between different web addresses). If the badge says Not connected, click Connect again and refresh the page.
Disconnect anytime: eBay → Settings → Connected applications → remove ListrApp.
One-time publish setup
Enter these once in step 4 (Publish). The app remembers them in your browser.
| Field in app | Where to get it |
|---|---|
| Merchant location key | eBay Seller Hub → inventory location (e.g. default). In the app, try Load from eBay. |
| Payment policy ID | ebay.com/bp/manage → Payment → open policy → number in the URL. |
| Return policy ID | Same page → Return policy → number in URL. |
| Fulfillment policy ID | Same page → Shipping policy → number in URL. |
| Category ID | In the app: Suggest categories, or copy from eBay when listing something similar. |
Your first listing
- Create listing tab → add photos (click or drag).
- Optional: keywords or price hint → Generate listing.
- Review – edit title, description, bullets.
- Category & price – Category ID, pricing research (eBay), set price.
- Publish – confirm policies → Publish selected channels.
Check title and price before publishing. The listing goes live on your eBay account.
My Listings
Track what you published from ListrApp: age, prices, item cost, estimated profit, views, watchers, shelf location, and status. Export to CSV anytime.
- Aging dots – a yellow dot means 20+ days with no sale (first nudge); a red dot means 45+ days (stale).
- -5% / -10% – drop the price on a flagged row with one tap (−10% appears on 45+ day rows for a deeper cut).
- Best Offer / Promote – turn on offers or set a Promoted Listings ad rate right from the row.
- Item cost & Shelf – click the cell to edit inline; item cost feeds estimated profit.
- Sync from eBay – update prices, views, and watchers.
- Edit on eBay – change title, description, or price on a live listing.
- Show Queue (Whatnot) – export an ordered sheet to prep a live show.
Channels: one-click vs Paste Kit
ListrApp labels every channel honestly so you always know what to expect. Cross-listing means you publish your own items to additional channels you choose — ListrApp does not redirect buyers or sales off a marketplace.
- One-click today: eBay, Shopify, TikTok Shop, Reverb.
- Reverb: Click Connect under Marketplace APIs and paste a Personal Access Token (see Reverb setup below). No OAuth wait.
- Pending: Etsy (draft in your shop), Depop, Whatnot.
- Paste Kit: Poshmark, Mercari, Vinted, Grailed, Facebook Marketplace, OfferUp, Craigslist. Open the site's create page, then use Copy next field to move through the form in order with progress tracking.
The term 'Etsy' is a trademark of Etsy, Inc. This application uses Etsy's API but is not endorsed or certified by Etsy.
The term 'eBay' is a trademark of eBay Inc. This application uses the eBay API but is not endorsed or certified by eBay.
The term 'Shopify' is a trademark of Shopify Inc. This application uses the Shopify API but is not endorsed or certified by Shopify.
The term 'Reverb' is a trademark of Reverb, LLC. This application uses Reverb's API but is not endorsed or certified by Reverb.
The term 'TikTok' is a trademark of TikTok Inc. This application uses the TikTok Shop API but is not endorsed or certified by TikTok.
The term 'Depop' is a trademark of Depop Limited. This application may use Depop's API when partner access is granted but is not endorsed or certified by Depop.
Connecting Reverb
Reverb uses Personal Access Tokens — not OAuth — so there is no approval wait.
In the app sidebar, under Marketplace APIs, click Connect next to Reverb,
and paste a token from reverb.com/my/api-tokens
with scopes read_listings, write_listings, and read_orders.
- Fill in Brand and Model item specifics when you can — Reverb needs make/model for clean drafts.
- Create shipping profiles on reverb.com first; the API can reference them but not create them.
- On publish (step 4), enable Include Reverb after your token is connected.
Operators: see REVERB_SETUP.md in the repo for sandbox testing (python -m scripts.test_reverb_connection).
Editing after publish
- Same session: Back → edit → Save changes to eBay.
- My Listings: Edit on eBay on an active row.
Pricing research (eBay)
On step 3, click Pricing research (eBay) or Recent sold prices. ListrApp uses your listing title to suggest a price from eBay sold and asking data—for your item only.
Privacy
ListrApp processes your photos, listing content, and marketplace connection tokens only to create and manage your own listings. Your data is private to your login and is not shared with other users. We do not sell your data or analyze other sellers' shops.
To disconnect eBay: eBay → Settings → Connected applications → remove ListrApp. For other channels, revoke the app in that marketplace's settings. Full details: Privacy Policy and Application Terms.
Get help
- Help chat – in the app sidebar (answers common questions automatically).
- This guide – sidebar → Guide, or print this page to PDF.
- Still stuck? Email support with the exact error text from the red banner and a screenshot.
Troubleshooting
| Issue | What to do |
|---|---|
| eBay: Not connected | Click Connect to eBay on this same site URL. Sign in and approve. Refresh the page. |
| Publish failed | Check Category ID and all four policy fields. Read the error message—it usually names what’s missing. |
| Page errors in Cursor preview | Use Chrome, Firefox, or Edge in a normal browser window. |
| Wrong account / someone else’s listings | Each invite is separate. Sign in with your invite; connect your eBay. Contact support if something looks wrong. |
| Category suggestions empty | Enter Category ID manually from a similar eBay listing. |
Save this guide as PDF
Click Print / Save as PDF at the top of this page, then choose Save as PDF in your browser.
Appendix: self-hosting (technical)
This section is for developers running their own copy—not beta testers on the hosted app.
Environment (.env)
Hosted ListrApp uses server-side keys. Self-hosters need ANTHROPIC_API_KEY, EBAY_CLIENT_ID, EBAY_CLIENT_SECRET, EBAY_RUNAME, and optional S3/Shopify variables. See .env.example in the project.
eBay Developer Portal
Create an app at developer.ebay.com, set RuName Auth Accepted URL to your callback (e.g. https://your-host/ebay/callback), set EBAY_SANDBOX=false for production.
Run locally
pip install -r requirements.txt
python main.pyFull technical docs: USER_GUIDE.md, EBAY_SETUP.md, SHOPIFY_SETUP.md.
The term "Etsy" is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.