{"id":377851,"date":"2026-09-30T13:29:18","date_gmt":"2026-09-30T13:29:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/suggestapi\/"},"modified":"2026-09-30T13:28:57","modified_gmt":"2026-09-30T13:28:57","slug":"suggestapi","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/suggestapi\/","author":23576378,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.2.0","stable_tag":"0.2.0","tested":"7.1.2","requires":"6.0","requires_php":"8.0","requires_plugins":null,"header_name":"SuggestAPI","header_author":"","header_description":"WordPress + WooCommerce connector for SuggestAPI. Search, background catalog sync, and agent discovery.","assets_banners_color":"020e13","last_updated":"2026-09-30 13:28:57","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":69,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.2.0":{"tag":"0.2.0","author":"cbsuggestapi","date":"2026-09-30 13:28:57","revision":3721337}},"upgrade_notice":{"0.2.0":"<p>Initial WordPress.org release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3721334,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3721334,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3721334,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3721334,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.2.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3721334,"resolution":"1","location":"assets","locale":"","width":1265,"height":712},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3721334,"resolution":"2","location":"assets","locale":"","width":1265,"height":712},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3721334,"resolution":"3","location":"assets","locale":"","width":1265,"height":712},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3721334,"resolution":"4","location":"assets","locale":"","width":1265,"height":712}},"screenshots":{"1":"Settings: keys, live index picker, and connectivity test.","2":"Advanced tab: sync toggles, batch sizes, shop box, and agent discovery.","3":"Catalog sync status: queue depth, reindex progress, and last sync.","4":"Storefront search box above the WooCommerce shop grid."}},"plugin_section":[],"plugin_tags":[3226,5183,944,3550,286],"plugin_category":[45],"plugin_contributors":[283701],"plugin_business_model":[],"class_list":["post-377851","plugin","type-plugin","status-publish","hentry","plugin_tags-autocomplete","plugin_tags-product-search","plugin_tags-search","plugin_tags-typeahead","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-cbsuggestapi","plugin_committers-cbsuggestapi"],"banners":{"banner":"https:\/\/ps.w.org\/suggestapi\/assets\/banner-772x250.png?rev=3721334","banner_2x":"https:\/\/ps.w.org\/suggestapi\/assets\/banner-1544x500.png?rev=3721334","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/suggestapi\/assets\/icon-128x128.png?rev=3721334","icon_2x":"https:\/\/ps.w.org\/suggestapi\/assets\/icon-256x256.png?rev=3721334","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/suggestapi\/assets\/screenshot-1.png?rev=3721334","caption":"Settings: keys, live index picker, and connectivity test."},{"src":"https:\/\/ps.w.org\/suggestapi\/assets\/screenshot-2.png?rev=3721334","caption":"Advanced tab: sync toggles, batch sizes, shop box, and agent discovery."},{"src":"https:\/\/ps.w.org\/suggestapi\/assets\/screenshot-3.png?rev=3721334","caption":"Catalog sync status: queue depth, reindex progress, and last sync."},{"src":"https:\/\/ps.w.org\/suggestapi\/assets\/screenshot-4.png?rev=3721334","caption":"Storefront search box above the WooCommerce shop grid."}],"raw_content":"<!--section=description-->\n<p>SuggestAPI adds fast, typo-tolerant product search to WordPress and WooCommerce,\nkeeps your SuggestAPI search index in sync in the background, and publishes an\nagent-discovery tag so AI shopping agents can find your catalog.<\/p>\n\n<ul>\n<li>Search box via the <code>[suggestapi_search]<\/code> shortcode or automatic injection\nabove the WooCommerce shop grid (<code>\/shop\/<\/code>).<\/li>\n<li>Server-side search proxy \u2014 your API keys never reach the browser.<\/li>\n<li>Background catalog sync: product creates, updates, stock changes, and deletes\nqueue through Action Scheduler (bundled with WooCommerce) with a WP-Cron\nfallback. Variable products sync per variation.<\/li>\n<li>Full catalog reindex with progress, retry with backoff, and error log.<\/li>\n<li>AI agent discovery: <code>ai-catalog<\/code> link tag resolved from the SuggestAPI agent\ngateway for your merchant domain.<\/li>\n<li>WP-CLI commands: <code>wp suggestapi status|test-connection|reindex|index-product<\/code>.<\/li>\n<\/ul>\n\n<p>You need a free SuggestAPI account: paste the public search key and the private\nwrite key from the dashboard, pick your product index from the live list, test\nconnectivity, and reindex.<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>This plugin connects your site to the SuggestAPI service\n(https:\/\/www.suggestapi.com). No data leaves your site until you save API keys.<\/p>\n\n<ul>\n<li>Storefront search: each query (<code>q<\/code>, result limit) and your index id are sent\nto <code>https:\/\/api.suggestapi.com<\/code> to fetch results. Your public key identifies\nyour account. No visitor cookies are set by these requests.<\/li>\n<li>Catalog sync (only with a private write key saved): product names,\ndescriptions, SKUs, prices, images, stock status, categories, and tags are\npushed to <code>https:\/\/api.suggestapi.com<\/code> to keep your search index current.<\/li>\n<li>Agent discovery (when enabled): your site domain is looked up at\n  https:\/\/agent.suggestapi.com to resolve your registered agent tenant, and\npages carry an <code>ai-catalog<\/code> link tag pointing at your catalog.<\/li>\n<\/ul>\n\n<p>SuggestAPI's terms and privacy policy apply to data it processes:\nhttps:\/\/www.suggestapi.com\/terms\/ and https:\/\/www.suggestapi.com\/privacy\/.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code> or install the zip via\nPlugins \u2192 Add New \u2192 Upload Plugin.<\/li>\n<li>Activate <strong>SuggestAPI<\/strong> through the Plugins screen.<\/li>\n<li>Open the <strong>SuggestAPI<\/strong> admin menu.<\/li>\n<li>Paste the public search key and private write key, save, pick the product\nindex from the dropdown, and save again.<\/li>\n<li>Click <strong>Test search connectivity<\/strong>, then <strong>Reindex all products<\/strong>.<\/li>\n<li>Put <code>[suggestapi_search]<\/code> on any page, or enable the shop search box.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20i%20get%20api%20keys%3F\"><h3>Where do I get API keys?<\/h3><\/dt>\n<dd><p>From the SuggestAPI dashboard. The public key powers storefront search; the\nprivate key powers background catalog sync and is never printed or sent to\nbrowsers.<\/p><\/dd>\n<dt id=\"which%20index%20should%20i%20pick%3F\"><h3>Which index should I pick?<\/h3><\/dt>\n<dd><p>Your own product index. Click Reload to fetch the live list from your account.\nDo not sync into shared demo indexes.<\/p><\/dd>\n<dt id=\"search%20works%20but%20sync%20stays%20dormant.%20why%3F\"><h3>Search works but sync stays dormant. Why?<\/h3><\/dt>\n<dd><p>Sync needs all three: WooCommerce active, sync enabled under the Advanced tab,\nand a private write key saved. The status panel shows exactly which is missing.<\/p><\/dd>\n<dt id=\"do%20ai%20agents%20see%20my%20catalog%3F\"><h3>Do AI agents see my catalog?<\/h3><\/dt>\n<dd><p>When the agent tag is enabled and your domain is a registered agent tenant,\nevery theme page emits <code>&lt;link rel=\"ai-catalog\" \u2026&gt;<\/code> pointing at your catalog.\nThe settings page shows the resolved tenant and a link to the live catalog.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20call%20suggestapi%20without%20keys%3F\"><h3>Does the plugin call SuggestAPI without keys?<\/h3><\/dt>\n<dd><p>No. Every outbound call checks for its key first; the REST proxy answers 503\nwhen unconfigured, and the shortcode renders no form until keys are saved.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Search proxy, shortcode, and shop grid search box.<\/li>\n<li>Variation-level background sync via Action Scheduler with batched writes.<\/li>\n<li>Agent ai-catalog discovery tag with API-resolved tenant.<\/li>\n<li>Settings General\/Advanced tabs, live index picker, WP-CLI commands.<\/li>\n<\/ul>","raw_excerpt":"WordPress + WooCommerce connector for SuggestAPI: fast product search, background catalog sync, and AI agent discovery.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/377851","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=377851"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/cbsuggestapi"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=377851"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=377851"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=377851"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=377851"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=377851"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=377851"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}