Blocks, builders & API
Place any Pro list with a block or page builder widget, and share recommendations with apps through a read-only API.
List types
| List | Shows |
|---|---|
| Recommended products (AI + rules) | The normal recommendations for a product, or the cart contents |
| Recommended for you | From the shopper's browsing |
| Recently viewed | The shopper's recently viewed products |
| Frequently bought together | Co-purchased products |
Block
Add AI Recommendations (Pro) (WooCommerce category): choose the List, a Product ID (0 = the product being viewed) and the Number of products (1–12). It supports wide and full alignment and spacing.
Elementor & Bricks
An AI Product Recommendations widget (Elementor) and element (Bricks, WooCommerce category) appear automatically when those builders are active, with the same List, Product ID and Number of products controls.
Shortcodes
[siteryn_ai_recommendations] Free: for a product or the cart [siteryn_ai_for_you limit="4"] Pro: recommended for you [siteryn_ai_recently_viewed limit="4"] Pro: recently viewed
Read-only API
Enable the Read-Only API
AI & Integrations → Integrations. Lets AI shopping agents, apps and headless storefronts read a product's recommendations.
GET /wp-json/siteryn-aipr/v1/recommendations?product_id=123&limit=4
{
"product_id": 123,
"recommendations": [
{ "id": 456, "name": "Linen Trousers", "url": "https://your-store.com/product/linen-trousers/",
"price": "59.00", "currency": "USD", "image": "https://your-store.com/wp-content/uploads/…" }
]
}
- The same list your store shows, with names, links, prices and images only.
limit1–12 (default 4), optionallang. - The price is the product's base price, before tax display settings.
- Cached for 5 minutes; limited to 60 requests per minute per visitor.
- Errors: 404 "Unknown or unavailable product.", 429 "Too many requests." When the API is off, the route doesn't exist.