POST /v1/data/shopify/products/run
Pricing: $0.001 per product ($1.00 per 1,000).
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Shopify store URL to crawl all products from, or an individual product URL.Format e.g.
https://www.example.com.Example
curl -X POST "https://api.mindcase.co/v1/data/shopify/products/run?wait=true" \
-H "Authorization: Bearer $MINDCASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"params": {
"urls": "https://undefeated.com",
"maxResults": 10
}
}'
import os, requests
r = requests.post(
"https://api.mindcase.co/v1/data/shopify/products/run",
params={"wait": "true"},
headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
json={"params": {
"urls": "https://undefeated.com",
"maxResults": 10
}},
)
job = r.json()
rows = job.get("data", []) # if job["status"] == "running", poll /v1/jobs/{job_id}/results
const r = await fetch("https://api.mindcase.co/v1/data/shopify/products/run?wait=true", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ params: {
"urls": "https://undefeated.com",
"maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
Response fields
Each row indata is one product, keyed by these fields.
| Field | Name | Type |
|---|---|---|
storeUrl | Store URL | url |
productUrl | Product URL | url |
productId | Product ID | text |
title | Title | text |
brand | Brand | text |
category | Category | text |
description | Description | text |
tags | Tags | array |
currency | Currency | text |
priceFrom | Price From | number |
priceTo | Price To | number |
onSale | On Sale | boolean |
inStock | In Stock | boolean |
variantCount | Variant Count | integer |
variants | Variants | object_array |
options | Options | object |
imageUrl | Image URL | url |
media | Media | object_array |
createdDate | Created Date | date |
publishedDate | Published Date | date |
recommendedProducts | Recommended Products | object_array |
Example response
Abridged: long text and lists are shortened.{
"job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
"agent": "shopify/products",
"status": "completed",
"row_count": 1,
"truncated": false,
"data": [
{
"variantCount": 18,
"productId": "6702685421829",
"variants": [
{
"variantId": "39754190192901",
"title": "- / 4.5",
"sku": "IQ3920-001---4.5",
"price": 3370.0,
"originalPrice": null,
"stockStatus": "OutOfStock"
},
{
"variantId": "39754190225669",
"title": "- / 5",
"sku": "IQ3920-001---5",
"price": 3370.0,
"originalPrice": null,
"stockStatus": "OutOfStock"
}
],
"brand": "NIKE",
"storeUrl": "https://undefeated.com",
"createdDate": "2026-08-07T18:09:22Z",
"priceTo": 3370.0,
"media": [
{
"url": "https://cdn.shopify.com/s/files/1/0282/5850/files/footwear_nike_air-force-1-low-protro-dodgers_IQ3920-001.view_1.jpg?v=1786644668",
"variantIds": []
},
{
"url": "https://cdn.shopify.com/s/files/1/0282/5850/files/footwear_nike_air-force-1-low-protro-dodgers_IQ3920-001.view_2.jpg?v=1786644668",
"variantIds": []
}
],
"inStock": true,
"description": "Final Sale. No refunds, exchanges or cancellations\nLimit one per customer. Orders with multiple quantities will be canceled and refunded",
"category": "Mens Footwear",
"priceFrom": 3370.0,
"tags": [
"26.Q3",
"finalsale"
],
"onSale": false,
"imageUrl": "https://cdn.shopify.com/s/files/1/0282/5850/files/footwear_nike_air-force-1-low-protro-dodgers_IQ3920-001.view_1.jpg?v=1786644668",
"publishedDate": "2026-08-15T14:12:54Z",
"recommendedProducts": [],
"title": "NIKE AIR FORCE 1 LOW PROTRO - WOLFGREY/ RUSHBLUE",
"options": {
"Colour": [
"-"
],
"Size": [
"4.5",
"5",
"5.5"
]
},
"productUrl": "https://undefeated.com/products/nike-air-force-1-low-protro-lad-wolf-grey-rush-blue",
"currency": "MDL"
}
]
}