Do I need an API key for order → invite?

Commerce and Pro can use a webhook token URL for storefront order events. Growth/Pro API keys are for POST /api/v1/invites and custom stacks — see https://ranqa.me/developers

Do widgets replace Schema.org AggregateRating?

No. Widgets embed a live score on your storefront. Search engines crawl AggregateRating on your public Ranqa company/product pages when reviews exist.

How long does a typical commerce setup take?

About 15 minutes for ready modules (token + webhook/plugin + test order). Catalog mapping and PDP widget placement may take longer depending on your theme.

← Integrations

WooCommerce review invites & widgets

Widget plus free plugin for completed orders. About 15 minutes end to end — verify your page free and keep reviews honest.

1. Widget

Add an iframe in the theme or via an HTML block.

<!-- Ranqa score badge — replace SLUG -->
<iframe
  src="https://ranqa.me/widget/SLUG?type=badge"
  width="280"
  height="90"
  style="border:0;overflow:hidden"
  title="RanqaScore"
  loading="lazy"
></iframe>

2. Order → invite

Install the Ranqa plugin, or use WooCommerce webhooks with the token URL.

Typical setup: ~15 minutes.

Download Ranqa for WooCommerce (.zip) →

Dashboard → Shopify / Woo: create a webhook token.
Install the plugin (or create a Woo webhook on Order completed).
Paste the token in WooCommerce → Ranqa (or use the token URL).
Place a test order and check Ranqa → Invites.

POST https://ranqa.me/api/v1/commerce/woocommerce/orders?token=YOUR_WEBHOOK_TOKEN
Content-Type: application/json

(WooCommerce order JSON — billing.email + line_items)

# Or: Authorization: Bearer rnq_… (Growth/Pro API key)

Open dashboard setup →

3. API

Same REST API as other integrations.

API documentation →

Setup FAQ

Do I need an API key for order → invite?: Commerce and Pro can use a webhook token URL for storefront order events. Growth/Pro API keys are for POST /api/v1/invites and custom stacks — see https://ranqa.me/developers
Do widgets replace Schema.org AggregateRating?: No. Widgets embed a live score on your storefront. Search engines crawl AggregateRating on your public Ranqa company/product pages when reviews exist.
How long does a typical commerce setup take?: About 15 minutes for ready modules (token + webhook/plugin + test order). Catalog mapping and PDP widget placement may take longer depending on your theme.