Storefront search via REST API
Custom CMS, headless commerce, and internal tools pair directly to Seekmodo's gateway — same ranking, merchandising, and MCP stack as connector installs, with HMAC-signed requests and first-party SDKs.
- /v1/search — shopper queries with typo tolerance and merchandising rules.
- /v1/index — catalog and content sync from your indexer workers.
- /v1/events — click and conversion telemetry for learning-to-rank.
Technical setup
This page covers the product and SEO story. First-party install guides and custom-connector API docs (for platforms we do not ship) live in the developer docs.
Core endpoints
- /v1/search — shopper queries with typo tolerance and merchandising rules.
- /v1/index — catalog and content sync from your indexer workers.
- /v1/events — click and conversion telemetry for learning-to-rank.
- OpenAPI document at /openapi.json — interactive reference at /docs/rest.
SDKs and auth
First-party JavaScript, PHP, Python, Ruby, and Go SDKs wrap HMAC signing, retries, and circuit-breaker plumbing. Mint tenant credentials from admin.seekmodo.com → Settings → Developer.
- JavaScript — @seekmodo/sdk for headless storefronts and Node workers.
- PHP — numinix/seekmodo-connector shared by Zen Cart and WordPress connectors.
- See /docs/sdk for language-specific guides.
API vs maintained connector
Use a connector when we ship one for your platform — sync, signing, fallback, and widgets are handled for you. Use the REST API when you run a custom CMS, proprietary PIM, or headless stack without a first-party plugin.
MCP alongside REST
Every paid tenant also gets MCP for agent workflows — REST and MCP share one index and merchandising rules. See /solutions/mcp-catalog-search.
Frequently asked questions
What are the rate limits?
Limits scale with your plan search quota. Contact support for enterprise throughput needs.
How does HMAC auth work?
Sign request bodies with your tenant secret; rotate keys from admin with a 10-minute overlap window. Details at /docs/rest.
How do I provision a tenant?
Sign up at /signup, create a tenant from the operator console, and mint API credentials. Sandbox requests available at /docs/sandbox.
Can I use this with Hydrogen or Next.js storefronts?
Yes — use the JavaScript SDK server-side or route through your BFF. Shopify merchants should also read /docs/shopify/install.
Is there a fallback layer?
Connectors ship Enhanced Native fallback; custom API integrations should implement degradation to your native search path when the gateway is unreachable.
Pair via REST API
Create a tenant, follow /docs/connectors/custom, and start a 14-day trial.