Search Stores
curl --request GET \
--url https://api.orbbit.co/v1/stores \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.orbbit.co/v1/stores"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.orbbit.co/v1/stores', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"id": "shopify_store_01k3a1b2c3d4e5f6g7h8j9k0mn",
"domain": "example-coffee.com",
"name": "Example Coffee Co.",
"country": "US",
"industry": "cpg",
"category": "coffee_and_tea",
"product_count": 84,
"variant_count": 212,
"min_price": 7.5,
"median_price": 18,
"max_price": 129,
"crawled_at": "2026-08-31T00:00:00.000Z",
"source": "shopify"
}
],
"next_cursor": null
}{
"error": {
"type": "invalid_request",
"message": "Unknown series: butter-spot"
}
}{
"error": {
"type": "unauthorized",
"message": "Missing or malformed Authorization: Bearer header"
}
}{
"error": {
"type": "forbidden",
"message": "This key is not scoped to search-stores"
}
}Shopify
Search Stores
Search the crawled Shopify stores — every filter optional, all combined.
Requires the search-stores scope.
The crawl covers stores in every industry. Pass industry=cpg to keep only consumer packaged goods brands.
GET
/
v1
/
stores
Search Stores
curl --request GET \
--url https://api.orbbit.co/v1/stores \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.orbbit.co/v1/stores"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.orbbit.co/v1/stores', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"id": "shopify_store_01k3a1b2c3d4e5f6g7h8j9k0mn",
"domain": "example-coffee.com",
"name": "Example Coffee Co.",
"country": "US",
"industry": "cpg",
"category": "coffee_and_tea",
"product_count": 84,
"variant_count": 212,
"min_price": 7.5,
"median_price": 18,
"max_price": 129,
"crawled_at": "2026-08-31T00:00:00.000Z",
"source": "shopify"
}
],
"next_cursor": null
}{
"error": {
"type": "invalid_request",
"message": "Unknown series: butter-spot"
}
}{
"error": {
"type": "unauthorized",
"message": "Missing or malformed Authorization: Bearer header"
}
}{
"error": {
"type": "forbidden",
"message": "This key is not scoped to search-stores"
}
}Authorizations
Your API key, which starts with orbbit_data_.
Query Parameters
Keep only stores whose domain contains this, ignoring case
Keep only stores whose name contains this, ignoring case
Exact match on the crawl’s verdict: cpg, partial_cpg, not_cpg, unknown
Exact match on a category the store sells in
Rows per page, default 50; anything above 200 is served as 200
Required range:
1 <= x <= 200The next_cursor of the previous page; absent starts from the first row