Developers
Let anyone share to Rec League from your site with a single link. When someone opens the link, we start a recommendation on their own Rec League with the details you pass pre-filled — ready for them to review and post. On a phone with the Rec League app installed, the link opens the app; everywhere else it works in the browser.
The link
Point a link or button at this endpoint with your details as query parameters:
https://recleague.com/recommendations/create/from-external?url=…&title=…&image=…&price=…¤cy=…Parameters
| Parameter | Required | Description |
|---|---|---|
url | Yes | The link to the thing being recommended (the product or article page). |
title | No | A title for the recommendation. Pre-fills the name field. |
image | No | A source image URL. We rehost it to our own CDN and run it through our image-enhance pipeline before using it. |
price | No | The price in major units as a decimal — e.g. 98.00 for $98.00 (not cents). |
currency | No | ISO 4217 currency code, lowercase (e.g. usd, gbp, eur). Defaults to usd. |
Encode each value exactly once with encodeURIComponent (in JavaScript) — don't double-encode an already-encoded URL, and don't pass a literal undefined for a value you don't have (omit the parameter instead). url is required; the rest are optional.
Example
https://recleague.com/recommendations/create/from-external?url=https%3A%2F%2Fexample.com%2Fproducts%2Fmerino-wool-sweater&title=Merino%20Wool%20Sweater&image=https%3A%2F%2Fexample.com%2Fimages%2Fsweater.jpg&price=98.00¤cy=usdDrop-in HTML button
<a href="https://recleague.com/recommendations/create/from-external?url=SOURCE_URL&title=TITLE&image=IMAGE_URL&price=PRICE¤cy=CURRENCY">
Share to Rec League
</a>Good to know
- The sharer needs to be signed in to Rec League. If they aren't, we'll ask them to sign in and then continue where they left off.
- The recommendation is created on the sharer's own Rec League — you don't need to know which one.
- We host the image you pass on our own CDN and enhance it before publishing, so a plain product-photo URL works well.
- Nothing is posted automatically — the sharer always lands in the composer to review and confirm.
Questions? Email us at support@recleague.com.