Search a Shopify Resource
shopify_searchSearch or list Shopify records such as products, orders, customers, and discounts across one store or several stores in parallel, with cursor pagination and resource-specific query filters.
Instructions
List or search one kind of record with cursor pagination, on one store (store) or several in parallel (stores; each store returns its own result and cursor). Resources:
products: Products (query: Shopify product search syntax).
collections: Manual and smart collections.
orders: Orders, newest first (query: Shopify order search syntax).
customers: Customers. Protected customer data permissions apply.
publications: Sales channel publication IDs (no query; 100 per page).
redirects: URL redirects.
pages: Online Store pages.
files: Files (images, videos, generic files).
metaobjects: Metaobjects of one type (type required).
markets: Markets (no query).
themes: Themes with their role; MAIN is live (no query).
delivery_profiles: Delivery profiles with zones, methods and flat rates (no query).
locations: Locations with address, active status and fulfillment capabilities (query: location search syntax).
price_lists: Price lists with currency, adjustment and catalog (no query).
metafield_definitions: Metafield definitions for one owner type (type required: PRODUCT, PRODUCTVARIANT, CUSTOMER, ORDER, COLLECTION, ...).
draft_orders: Draft orders, most recently updated first (query: draft order search syntax).
webhooks: This app's webhook subscriptions (query: such as "topic:ORDERS_CREATE"). Shopify shows an app only the webhook subscriptions it created; other apps' subscriptions are not listed.
blogs: Online Store blogs (query: such as "handle:news" or "title:Recipes"). Returns id, title, handle, commentPolicy, articlesCount, templateSuffix, updatedAt.
metaobject_definitions: Metaobject definitions: type, name, displayNameKey, field definitions (key, name, type, required), entry count, access and capabilities. No query filter; page with after.
marketing_events: Marketing events (campaigns, ads, posts) recorded by marketing apps, newest first: id, type, remoteId, startedAt, endedAt, description, marketingChannelType, utm fields and sourceAndMedium. query: Shopify search syntax such as "started_at:>=2026-10-01" or "type:AD".
abandoned_checkouts: Abandoned checkouts, newest first: id, name, createdAt, updatedAt, abandonedCheckoutUrl, totalPriceSet, customer id and email when present, and lineItemsQuantity (units, not distinct lines). Needs the protected customer data permission for customer fields; Shopify returns only checkouts from the last 90 days. query: such as "created_at:>=2026-10-01".
discounts: Code and automatic discounts, newest first, with title, status (ACTIVE, SCHEDULED, EXPIRED), type (__typename), summary, startsAt, endsAt, usage count and the first 3 codes of code discounts. query: Shopify discount search syntax, such as "status:active", "method:code", "type:percentage" (also fixed_amount, free_shipping, bxgy), "title:summer", "times_used:>0" or "starts_at:>2026-11-01".
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"resource": "<resource>"
},
"name": "shopify_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | metaobjects: the metaobject type. metafield_definitions: the owner type, such as PRODUCT or CUSTOMER. | |
| after | No | Cursor from pageInfo.endCursor (single store only). | |
| first | No | ||
| query | No | Shopify search syntax for the resource, where it takes one. | |
| store | No | One store alias. Give store or stores. | |
| stores | No | Several store aliases, searched in parallel. | |
| resource | Yes |