Title: SuggestAPI
Author: cbsuggestapi
Published: 2026-يىلى 30-سېنتەبىر
Last modified: 2026-يىلى 30-سېنتەبىر
---
قىستۇرما ئىزدە
# SuggestAPI
يازغۇچى [cbsuggestapi](https://profiles.wordpress.org/cbsuggestapi/)
[چۈشۈر](https://downloads.wordpress.org/plugin/suggestapi.0.2.0.zip)
* [تەپسىلاتلار](https://ug.wordpress.org/plugins/suggestapi/#description)
* [باھالاشلار](https://ug.wordpress.org/plugins/suggestapi/#reviews)
* [ئورنىتىش](https://ug.wordpress.org/plugins/suggestapi/#installation)
* [ئىجادىيەت](https://ug.wordpress.org/plugins/suggestapi/#developers)
[قوللاش](https://wordpress.org/support/plugin/suggestapi/)
## چۈشەندۈرۈش
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/.
## ئېكران كەسمىسى
[⌊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.
## ئورنىتىش
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.
## باھالاشلار
بۇ قىستۇرمىغا تېخى باھا يېزىلمىدى.
## تۆھپىكار ۋە ئىجادكار
«SuggestAPI» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا تۆھپە قوشقان.
تۆھپىكار
* [ cbsuggestapi ](https://profiles.wordpress.org/cbsuggestapi/)
[«SuggestAPI» نى تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/suggestapi)
### ئىجادىيەتكە قىزىقامسىز؟
[كودقا كۆز يۈگۈرتۈپ](https://plugins.trac.wordpress.org/browser/suggestapi/)، [SVN خەزىنە](https://plugins.svn.wordpress.org/suggestapi/)
تەكشۈرۈپ ياكى [RSS](https://plugins.trac.wordpress.org/log/suggestapi/?limit=100&mode=stop_on_copy&format=rss)
ئارقىلىق [ئىجادىيەت خاتىرىسى](https://plugins.trac.wordpress.org/log/suggestapi/)
گە مۇشتەرى بولغىلى بولىدۇ.
## ئۆزگىرىش خاتىرىسى
#### 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**
* ئاخىرقى يېڭىلانغان ۋاقىت **4 كۈن بۇرۇن**
* ئاكتىپ ئورنىتىش سانى **10 دىن ئاز**
* WordPress نەشرى ** 6.0 ياكى يۇقىرى **
* **7.1.2** دا سىنالغان
* PHP نەشرى ** 8.0 ياكى يۇقىرى **
* تىل
* [English (US)](https://wordpress.org/plugins/suggestapi/)
* بەلگە
* [autocomplete](https://ug.wordpress.org/plugins/tags/autocomplete/)[product search](https://ug.wordpress.org/plugins/tags/product-search/)
[search](https://ug.wordpress.org/plugins/tags/search/)[typeahead](https://ug.wordpress.org/plugins/tags/typeahead/)
[woocommerce](https://ug.wordpress.org/plugins/tags/woocommerce/)
* [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/suggestapi/advanced/)
## دەرىجە
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/suggestapi/reviews/#new-post)
[بارلىق ئىنكاسنى كۆرسەت](https://wordpress.org/support/plugin/suggestapi/reviews/)
## تۆھپىكار
* [ cbsuggestapi ](https://profiles.wordpress.org/cbsuggestapi/)
## قوللاش
چۈشەندۈرۈشىڭىز بارمۇ؟ ياردەم لازىممۇ؟
[قوللاش مۇنبىرىنى كۆرسەت](https://wordpress.org/support/plugin/suggestapi/)