Seekmodo developer docs

Reference for the REST shim, MCP JSON-RPC surface, and storefront connectors. Authenticate with HMAC; replay window is 5 minutes.

Connectors

Pre-built plugins for the popular storefront platforms. Each plugin handles HMAC signing, the search swap-point, and the indexer cron for you.

Available
Drop-in plugin for Zen Cart 1.5.7+. Swaps your storefront search over to Seekmodo and keeps the catalog in sync. Three modes — off, learning, active — let you cut over without surprises.
  1. Download the connector from your account portal once your trial is set up.
  2. Drop it into your Zen Cart's zc_plugins/ directory and visit Admin → Plugin Manager → Install.
  3. Click 'Connect to Seekmodo' in your store admin to pair the install with your Seekmodo account in one step (no API keys to copy).
  4. Run a week in 'learning' mode to verify, then flip to 'active'.

Full install guideTroubleshootingDownload & changelog

Available
WordPress 6.2+ plugin for content sites and stores running WooCommerce. Auto-detects Custom Post Types and routes WP search through Seekmodo with WP_Query as the always-on fallback. Activates the bundled WooCommerce vertical automatically when WC is detected.
  1. Download the latest seekmodo-wordpress-*.zip from your account portal.
  2. WordPress admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.
  3. Open Settings → Seekmodo and click 'Connect to Seekmodo' — the plugin round-trips to seekmodo.com and pairs your tenant automatically.
  4. WP search now flows through Seekmodo with WP_Query as the always-on fallback. Run in 'learning' for a week, then flip to 'active'.
  5. If WooCommerce is installed on the same site, the commerce vertical auto-activates and indexes products on the next bulk-indexer tick (or run `wp seekmodo index --full`). No second plugin needed.

TroubleshootingDownload & changelog

Available
Native WooCommerce product search via the Seekmodo WordPress plugin: variation-aware, on-sale faceted, stock-aware. Same zip as the WordPress connector — install once, light up both verticals.
  1. Download the latest seekmodo-wordpress-*.zip from your account portal — WooCommerce ships inside the same WordPress connector zip.
  2. WordPress admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.
  3. On activation the plugin auto-detects WooCommerce. The commerce vertical lights up alongside the content vertical without any toggles.
  4. Open Settings → Seekmodo and click 'Connect to Seekmodo' to pair the tenant.
  5. Run `wp seekmodo index --full` (or wait for the bulk-indexer cron tick) to seed products, variations, brands, categories, and stock state into the gateway.
  6. Run in 'shadow' for a week to verify relevance against your top product searches, then flip to 'active'. WooCommerce's native `WC_Product_Query` stays armed as the always-on fallback.

TroubleshootingDownload & changelog

Available
Magento 2.4+ module for Open Source and Adobe Commerce. Enhanced Native improves catalog search on install; pair for gateway AI search, multi-store indexing, and Growth-tier widgets.
  1. Download seekmodo-magento-v*.zip from seekmodo.com/plugins/magento or require via Composer: `composer require numinix/module-seekmodo`.
  2. Enable the module: `bin/magento module:enable Numinix_Seekmodo && bin/magento setup:upgrade && bin/magento cache:flush`.
  3. Admin → System → Seekmodo → Connect → Connect to Seekmodo to pair your tenant.
  4. Run `bin/magento seekmodo:index --full` to seed products and CMS pages per store view.
  5. Run in shadow mode for a week, then flip to active on admin.seekmodo.com. Native OpenSearch/Elasticsearch stays the degradation floor.

Download & changelog

Official BigCommerce App Marketplace connector. OAuth install pairs your store to Seekmodo for AI search, vehicle fitment, VLPs, recommendations, and Script Manager storefront widgets.
  1. Install Seekmodo from the BigCommerce App Marketplace (or open https://bigcommerce-app.seekmodo.com/install from a store admin session).
  2. Allow the OAuth scopes (Information read-only, Products, Customers, Content).
  3. Complete pairing at seekmodo.com/connect — pick or create your Seekmodo tenant.
  4. Open Apps → Seekmodo to confirm pairing and wait for the first catalog index.
  5. Map custom fields in the admin iframe if your part numbers use merchant-specific names (e.g. EZ # → ez_number).
  6. Optional Stencil/Catalyst snippets live in the connector docs/storefront-snippets/ for theme-specific vehicle UI.

Full install guideDownload & changelog

Roll your own with the REST or MCP API. Every endpoint is documented and there's an interactive sandbox you can sign requests against with a demo tenant key.
  1. Grab your tenant_id and shared secret at admin.seekmodo.com → Settings → Developer / API credentials. Rotate the secret any time; old keys stay valid for 10 minutes during rotation.
  2. Pick a stack — Node, Python, PHP, Ruby, Go all work.
  3. Sign requests with HMAC-SHA256 (see the REST tab for the canonical request shape).
  4. Hit POST /v1/search to verify; you should see results within ~50ms.

Full install guideREST API reference

Want to test a request without writing any code? Try the Sandbox — we sign with a demo tenant key on the server side.

Building a custom PHP storefront connector? The first-party Zen Cart and WordPress connectors all ship on top of the PHP SDK (composer require numinix/seekmodo-connector) — same HMAC + circuit-breaker + mode-FSM + pairing plumbing, ready to drop into your platform-specific glue.