Title: SuggestAPI
Author: cbsuggestapi
Published: September 30, 2026
Last modified: September 30, 2026
---
Search plugins
# SuggestAPI
By [cbsuggestapi](https://profiles.wordpress.org/cbsuggestapi/)
[Download](https://downloads.wordpress.org/plugin/suggestapi.0.2.0.zip)
* [Details](https://wordpress.org/plugins/suggestapi/#description)
* [Reviews](https://wordpress.org/plugins/suggestapi/#reviews)
* [Installation](https://wordpress.org/plugins/suggestapi/#installation)
* [Development](https://wordpress.org/plugins/suggestapi/#developers)
[Support](https://wordpress.org/support/plugin/suggestapi/)
## Description
SuggestAPI adds fast, typo-tolerant product search to WordPress and WooCommerce,
keeps your SuggestAPI search index in sync in the background, and publishes an agent-
discovery tag so AI shopping agents can find your catalog.
* Search box via the `[suggestapi_search]` shortcode or automatic injection
above
the WooCommerce shop grid (`/shop/`).
* Server-side search proxy — your API keys never reach the browser.
* Background catalog sync: product creates, updates, stock changes, and deletes
queue through Action Scheduler (bundled with WooCommerce) with a WP-Cron fallback.
Variable products sync per variation.
* Full catalog reindex with progress, retry with backoff, and error log.
* AI agent discovery: `ai-catalog` link tag resolved from the SuggestAPI agent
gateway for your merchant domain.
* WP-CLI commands: `wp suggestapi status|test-connection|reindex|index-product`.
You need a free SuggestAPI account: paste the public search key and the private
write key from the dashboard, pick your product index from the live list, test connectivity,
and reindex.
### Privacy
This plugin connects your site to the SuggestAPI service
(https://www.suggestapi.
com). No data leaves your site until you save API keys.
* Storefront search: each query (`q`, result limit) and your index id are sent
to `https://api.suggestapi.com` to fetch results. Your public key identifies
your account. No visitor cookies are set by these requests.
* Catalog sync (only with a private write key saved): product names,
descriptions,
SKUs, prices, images, stock status, categories, and tags are pushed to `https://
api.suggestapi.com` to keep your search index current.
* Agent discovery (when enabled): your site domain is looked up at
https://agent.
suggestapi.com to resolve your registered agent tenant, and pages carry an `ai-
catalog` link tag pointing at your catalog.
SuggestAPI’s terms and privacy policy apply to data it processes:
https://www.suggestapi.
com/terms/ and https://www.suggestapi.com/privacy/.
## Screenshots
[⌊Settings: keys, live index picker, and connectivity test.⌉⌊Settings: keys, live
index picker, and connectivity test.⌉[
Settings: keys, live index picker, and connectivity test.
[⌊Advanced tab: sync toggles, batch sizes, shop box, and agent discovery.⌉⌊Advanced
tab: sync toggles, batch sizes, shop box, and agent discovery.⌉[
Advanced tab: sync toggles, batch sizes, shop box, and agent discovery.
[⌊Catalog sync status: queue depth, reindex progress, and last sync.⌉⌊Catalog sync
status: queue depth, reindex progress, and last sync.⌉[
Catalog sync status: queue depth, reindex progress, and last sync.
[⌊Storefront search box above the WooCommerce shop grid.⌉⌊Storefront search box
above the WooCommerce shop grid.⌉[
Storefront search box above the WooCommerce shop grid.
## Installation
1. Upload the plugin folder to `/wp-content/plugins/` or install the zip via Plugins
Add New Upload Plugin.
2. Activate **SuggestAPI** through the Plugins screen.
3. Open the **SuggestAPI** admin menu.
4. Paste the public search key and private write key, save, pick the product index
from the dropdown, and save again.
5. Click **Test search connectivity**, then **Reindex all products**.
6. Put `[suggestapi_search]` on any page, or enable the shop search box.
## FAQ
### Where do I get API keys?
From the SuggestAPI dashboard. The public key powers storefront search; the
private
key powers background catalog sync and is never printed or sent to browsers.
### Which index should I pick?
Your own product index. Click Reload to fetch the live list from your account.
Do not sync into shared demo indexes.
### Search works but sync stays dormant. Why?
Sync needs all three: WooCommerce active, sync enabled under the Advanced tab,
and a private write key saved. The status panel shows exactly which is missing.
### Do AI agents see my catalog?
When the agent tag is enabled and your domain is a registered agent tenant,
every
theme page emits `` pointing at your catalog. The settings
page shows the resolved tenant and a link to the live catalog.
### Does the plugin call SuggestAPI without keys?
No. Every outbound call checks for its key first; the REST proxy answers 503
when
unconfigured, and the shortcode renders no form until keys are saved.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“SuggestAPI” is open source software. The following people have contributed to this
plugin.
Contributors
* [ cbsuggestapi ](https://profiles.wordpress.org/cbsuggestapi/)
[Translate “SuggestAPI” into your language.](https://translate.wordpress.org/projects/wp-plugins/suggestapi)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/suggestapi/), check
out the [SVN repository](https://plugins.svn.wordpress.org/suggestapi/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/suggestapi/) by
[RSS](https://plugins.trac.wordpress.org/log/suggestapi/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 0.2.0
* Search proxy, shortcode, and shop grid search box.
* Variation-level background sync via Action Scheduler with batched writes.
* Agent ai-catalog discovery tag with API-resolved tenant.
* Settings General/Advanced tabs, live index picker, WP-CLI commands.
## Meta
* Version **0.2.0**
* Last updated **1 day ago**
* Active installations **Fewer than 10**
* WordPress version ** 6.0 or higher **
* Tested up to **7.1.2**
* PHP version ** 8.0 or higher **
* Tags
* [autocomplete](https://wordpress.org/plugins/tags/autocomplete/)[product search](https://wordpress.org/plugins/tags/product-search/)
[search](https://wordpress.org/plugins/tags/search/)[typeahead](https://wordpress.org/plugins/tags/typeahead/)
[woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
* [Advanced View](https://wordpress.org/plugins/suggestapi/advanced/)
## Ratings
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/suggestapi/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/suggestapi/reviews/)
## Contributors
* [ cbsuggestapi ](https://profiles.wordpress.org/cbsuggestapi/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/suggestapi/)