Finds your Shopify product's rank in the AI shopping catalog for any search keywords.
Checks how well a Shopify store's products show up when AI shopping assistants such as ChatGPT, Gemini, Perplexity, Grok, and Copilot search for products, and reports the store's rank and its closest competitors. Searches Shopify's real Global Catalog — the same product index AI assistants read from.
https://shopify-ai-rank-checker.underscoredone.com/rank$0.05 per request — pay via x402/USDC. No account needed.
Call this when a user wants to know how visible their Shopify store is to AI shopping assistants for specific search terms. Provide the store's myshopify.com domain and a list of search keywords. Use 'simple' report_detail for a quick rank check, or 'full' for complete competitor data and a data quality score. Keep keyword lists to 10 or fewer per call for faster responses; split larger lists into multiple calls.
| Name | Type | Required | Description |
|---|---|---|---|
shop_domain | string | yes | Your store's web address, for example legacybilliards.com or example-store.myshopify.com. You can paste it with or without https://. |
keywords | array | yes | A list of 1 to 10 search phrases you want to check your store's rank for. Split larger lists across multiple calls. |
report_detail | string | no | Choose 'simple' for a quick rank summary or 'full' for complete competitor and data quality details. |
ships_to_country | string | no | A two-letter country code, such as US or DE, so results reflect what a shopper in that country would see. |
{
"api_version": "1.0.0",
"results": [
{
"keyword": "7 foot pool table",
"rank": 2,
"urlFound": "https://www.legacybilliards.com/products/baylor-ii-7-ft-pool-table-modern",
"top10Results": [
"https://www.playgosports.com/products/gosports-mid-size",
"https://www.legacybilliards.com/products/baylor-ii-7-ft-pool-table-modern"
]
}
]
}
| Status | Meaning |
|---|---|
400 | Bad request — your input failed validation or could not be processed. Check the detail field for specifics. |
402 | Payment required. Send a signed USDC payment on Base Mainnet or Solana Mainnet using the x402 protocol. |
422 | Unprocessable — a required field is missing or the wrong type. Check the detail field for specifics. |