API Reference
Table of Contents
Overview
The Store Leads API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP verbs, which are understood by off-the-shelf HTTP clients. JSON is returned by all API responses, including errors.
The example requests within our documentation are shown using your personal API key. This is done for your convenience, so that you can cut and paste the examples. Be sure to keep your personal API key private.
Authentication
Authenticate your account by including your API key in requests. You can see your API key on your Account page.
Authentication is done by including your API key in an HTTP Authorization header.
Authorization: Bearer your.api.key
All API requests must be made over HTTPS. API requests without authentication will fail.
Errors
We use conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, etc.). Codes in the 5xx range indicate an error with our servers (these are rare).
Resources
Apps
App objects represent an app that a store can install through the e-commerce platform's App Store. For instance, Merchant Mail is an app that can be installed through the Shopify App Store.
The attributes of the App object are documented below.
The time at which the App was installed by a Domain.
- Active
- Inactive (ie. removed from the App Store)
Retrieve an App
Retrieves the details of an App. The app is identified by combining the platform name with the app token (e.g., "shopify.marsello")
Example Request
$ curl -H 'Authorization: Bearer your.api.key' 'https://storeleads.app/json/api/v1/all/app/shopify.marsello'
Example Response
{
"app": {
"id": "1.marsello",
"token": "marsello",
"name": "Marsello",
"categories": [
"marketing"
],
"app_store_url": "https://apps.shopify.com/marsello",
"plans": [
{
"name": "Free to install",
"monthly_cost": "Free to install"
}
],
"description": "Sell more with email, SMS, rewards programs, recommendations",
"installs": 3263,
"platform": "shopify",
"vendor_name": "Marsello",
"vendor_url": "https://apps.shopify.com/partners/recovermycart",
"vendor_email": "help@marsello.com",
"review_count": 306,
"average_rating": "4.3",
"icon_url": "https://apps.shopifycdn.com/listing_images/01610b7070e1a444e4229cbef477e025/icon/573fd08d59e91ed2680ee1e390f76802.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
}
}
List Apps
Returns a list of Apps. By default, 50 Apps are returned in a single request. Use the page request option can be used to paginate.
Request Options
Filters the results to Apps that belong to the provided categories. Multiple categories must be comma-separated.
The boolean operation to apply to values provided in the f:categories request option (if multiple values are provided).
Possible values:
- and (default): Returns Apps matching all provided values.
- or: Returns Apps matching any provided value.
- not: Returns Apps that do not match any of the provided values.
Filters the results to Apps with install counts greater than or equal to the provided integer value.
Filters the results to Apps with install counts than or equal to the provided integer value.
Filters the results to Apps on the given e-commerce platform. Multiple values must be comma-separated.
Valid values are:
- woocommerce
- shopify
- wix
- prestashop
- magento
- bigcartel
- square
- ecwid
- opencart
- bigcommerce
- base
- squarespace
- storesjp
- shopline
- volusion
- 3dcart
- salla
- lightspeed
- hcl
- demandware
- sap
- nop
- webflow
- shopmatic
- spreecommerce
- miva
- shopware
- expandcart
- atg
- zid
- easystore
- oracle
- ecomz
- shopcada
The boolean operation to apply to values provided in the f:p request option (if multiple values are provided).
Possible values:
- and (default): Returns Apps matching all provided values.
- or: Returns Apps matching any provided value.
- not: Returns Apps that do not match any of the provided values.
Filters the results to Apps with review counts greater than or equal to the provided integer value.
Filters the results to Apps with review counts than or equal to the provided integer value.
A comma-separated list of fields to include in the response. All fields are returned if left blank. If you only need a subset of fields in the response, it is recommended to use this request parameter since it can have a significant impact on response time.
Nested fields can be specified using a period to separate the field name and the nested field name. For instance,
using fields=name,plans.name
would return the name field from each App and the name field for all plans
on each App.
The page of results to return. Default: 0.
The number of Apps to return in a single query. Default: 50, Max: 50.
Changes the sort order. Multiple sort fields can be provided (comma-separated). Prefix fields with a minus sign (-) to denote descending sort order.
Valid fields are:
- average_rating
- created_at
- installs
- removed_at
- reviews
Example Request
$ curl -H 'Authorization: Bearer your.api.key' 'https://storeleads.app/json/api/v1/all/app?page_size=2&f:p=shopify&f:categories=marketing'
Search requests can also be triggered via HTTP POST.
$ curl -H 'Authorization: Bearer your.api.key' -H "Content-Type: application/json" -X POST -d '{"page_size":2,"f:p":"shopify","f:categories":"marketing"}' 'https://storeleads.app/json/api/v1/all/app'
Example Response
{
"apps": [
{
"id": "1.privy",
"token": "privy",
"name": "Privy ‑ Pop Ups, Email, \u0026 SMS",
"categories": [
"store design",
"marketing",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/privy",
"plans": [
{
"name": "Free",
"monthly_cost": "Free to install"
},
{
"name": "Privy Convert",
"monthly_cost": "$20/month",
"monthly_cost_cents": 2000
},
{
"name": "Privy Email",
"monthly_cost": "$13/month",
"monthly_cost_cents": 1300
},
{
"name": "Privy Starter Plan",
"monthly_cost": "$30/month",
"monthly_cost_cents": 3000
}
],
"description": "Exit Popup, Email Marketing, Free Shipping Bar, Abandoned Cart",
"installs": 84118,
"platform": "shopify",
"vendor_name": "Privy",
"vendor_url": "https://apps.shopify.com/partners/privy",
"vendor_email": "support@privy.com",
"review_count": 24450,
"average_rating": "4.6",
"icon_url": "https://apps.shopifycdn.com/listing_images/f3d61c764a54b22aed51cd1cc31b5a74/icon/c263739fc9dd20f4706301270ad3d466.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.free-shipping-bar",
"token": "free-shipping-bar",
"name": "Free Shipping Bar",
"categories": [
"store design",
"marketing",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/free-shipping-bar",
"plans": [
{
"name": "Basic Plan",
"monthly_cost": "Free"
},
{
"name": "Premium Plan",
"monthly_cost": "$9.99/month",
"monthly_cost_cents": 999
}
],
"description": "Free shipping bar with updated cart goal to boost order value",
"installs": 52126,
"platform": "shopify",
"vendor_name": "Hextom",
"vendor_url": "https://apps.shopify.com/partners/hextom",
"vendor_email": "help@hextom.com",
"review_count": 9987,
"average_rating": "4.9",
"icon_url": "https://apps.shopifycdn.com/listing_images/635cce572624d1086ac37403cf25b5ee/icon/390b8ec270438793fd37f05da12ee6bb.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
}
]
}
Domains
Domain objects represent an online store identified by a DNS domain name. The API allows you to retrieve information for a domain based on its name.
The attributes of the Domain object are documented below.
The average price of products sold on the Domain. Values in the minor unit of the Domain's currency (e.g., cents of USD).
A list of contact information available for the Domain. This includes email addresses, phone numbers and social media accounts. The following attributes are included:
- followers: number of followers (present only for twitter, instagram, facebook, pinterest and youtube handles)
- followers_30d: change in number of followers over last 30 days
- followers_90d: change in number of followers over last 90 days
- source: relative url of the page that the contact information was found
- type: the type of contact information (email, phone, twitter, facebook, instagram, pinterest, youtube, snapchat)
- value: the contact information (email address, phone number or url to social network handle)
Note that some values may be redacted to comply with local privacy laws. See our Privacy Policy for more details.
The number of employees.
The estimated total monthly sales for the merchant. Values in cents of USD.
The date at which the Domain last changed e-commerce platforms (if any). Note: Data not available for Domains that changed e-commerce platforms prior to October 2019.
This field is only available on the Elite plan.
The name of the pricing plan that the Domain was previously on (if any). Note: Data not available for Domains that changed plans prior to July 2019.
The date at which the Domain last changed pricing plans (if any). Note: Data not available for Domains that changed plans prior to July 2019.
This field is only available on the Elite plan.
The number of products sold by the Domain.
Product counts are precise for standard Shopify stores. For all other stores, product counts are an estimate.
- Active
- Inactive
- Password Protected
- Redirect
- name
- description
- Dropshipper
- Print on Demand
- Trending on Facebook
- Trending on Instagram
- Trending on Pinterest
- Trending on TikTok
- Trending on Twitter
- Trending on YouTube
- Dropping on Facebook
- Dropping on Instagram
- Dropping on Pinterest
- Dropping on TikTok
- Dropping on Twitter
- Dropping on YouTube
- name
- style
- cost (in cents of USD)
- vendor
- version (for some themes only)
The number of distinct vendors of products sold by the Domain.
Vendor counts are only available for Shopify stores.
Retrieve a Domain
Retrieves the details of a Domain. You must provide the name of the Domain to lookup. The name can either be the public DNS domain name (e.g., merchant.com) or the provider domain (e.g., merchant.myshopify.com).
Example Request
$ curl -H 'Authorization: Bearer your.api.key' 'https://storeleads.app/json/api/v1/all/domain/www.vapes.com'
Example Response
{
"domain": {
"alexa_rank": 280571,
"aliases": [
"vapescom.myshopify.com"
],
"apps": [
{
"id": "1.also-bought",
"token": "also-bought",
"name": "Also Bought • Cross Sell",
"categories": [
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/also-bought",
"plans": [
{
"name": "$9.99/month",
"monthly_cost": "$9.99/month",
"monthly_cost_cents": 999
}
],
"description": "Best related product recommendations. Awarded Best App!",
"installs": 5984,
"installed_at": "2018-08-21T00:00:00Z",
"platform": "shopify",
"vendor_name": "Code Black Belt",
"vendor_url": "https://apps.shopify.com/partners/codeblackbelt",
"vendor_email": "support@codeblackbelt.com",
"review_count": 619,
"average_rating": "4.9",
"icon_url": "https://apps.shopifycdn.com/listing_images/55a595d2413473dd0c6e6a315690886a/icon/d101da2a9943db5042ec669806ccb1a7.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.back-in-stock",
"token": "back-in-stock",
"name": "Back In Stock: Customer Alerts",
"categories": [
"sales and conversion optimization",
"orders and shipping",
"inventory management"
],
"app_store_url": "https://apps.shopify.com/back-in-stock",
"plans": [
{
"name": "Free",
"monthly_cost": "Free"
},
{
"name": "Startup",
"monthly_cost": "$19/month",
"monthly_cost_cents": 1900
},
{
"name": "Small Business",
"monthly_cost": "$39/month",
"monthly_cost_cents": 3900
},
{
"name": "Medium Store",
"monthly_cost": "$59/month",
"monthly_cost_cents": 5900
}
],
"description": "Notify your customers when products are restocked: Email \u0026 SMS",
"installs": 14408,
"installed_at": "2018-08-21T00:00:00Z",
"platform": "shopify",
"vendor_name": "SureSwift Capital",
"vendor_url": "https://apps.shopify.com/partners/wdh",
"vendor_email": "support@backinstock.org",
"review_count": 352,
"average_rating": "4.9",
"icon_url": "https://apps.shopifycdn.com/listing_images/08346a36a0a313120feec14003bedbc3/icon/49b8ec038ce4eb9d6f3516c63ca00385.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.cm-commerce",
"token": "cm-commerce",
"name": "CM Commerce Email Marketing",
"categories": [
"store design",
"marketing",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/cm-commerce",
"plans": [
{
"name": "Free to install",
"monthly_cost": "Free to install"
}
],
"description": "Email Marketing Automation, Reviews \u0026 Popups",
"installs": 860,
"installed_at": "2020-04-06T00:00:00Z",
"platform": "shopify",
"vendor_name": "Campaign Monitor",
"vendor_url": "https://apps.shopify.com/partners/receiptful",
"vendor_email": "help.cmcommerce@campaignmonitor.com",
"review_count": 1027,
"average_rating": "4.6",
"icon_url": "https://apps.shopifycdn.com/listing_images/05d3dad30666912ea0d52df60e35de42/icon/b70756bc82aafb33fa5a9d3bde3f2ba7.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2019-10-02T00:00:00"
},
{
"id": "1.free-shipping-bar",
"token": "free-shipping-bar",
"name": "Free Shipping Bar",
"categories": [
"store design",
"marketing",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/free-shipping-bar",
"plans": [
{
"name": "Basic Plan",
"monthly_cost": "Free"
},
{
"name": "Premium Plan",
"monthly_cost": "$9.99/month",
"monthly_cost_cents": 999
}
],
"description": "Free shipping bar with updated cart goal to boost order value",
"installs": 52126,
"installed_at": "2020-11-10T00:00:00Z",
"platform": "shopify",
"vendor_name": "Hextom",
"vendor_url": "https://apps.shopify.com/partners/hextom",
"vendor_email": "help@hextom.com",
"review_count": 9985,
"average_rating": "4.9",
"icon_url": "https://apps.shopifycdn.com/listing_images/635cce572624d1086ac37403cf25b5ee/icon/390b8ec270438793fd37f05da12ee6bb.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.generic-zotabox",
"token": "generic-zotabox",
"name": "Zotabox",
"app_store_url": "https://apps.shopify.com/partners/zotabox",
"description": "Boost Your Sales with 15 Free Marketing Tools",
"installs": 18386,
"installed_at": "2018-08-21T00:00:00Z",
"platform": "shopify",
"vendor_name": "Zotabox",
"vendor_url": "https://info.zotabox.com/",
"state": "Active",
"created_at": "2018-11-01T00:00:00"
},
{
"id": "1.mailchimp",
"token": "mailchimp",
"name": "Mailchimp",
"categories": [
"marketing"
],
"app_store_url": "https://apps.shopify.com/mailchimp",
"plans": [
{
"name": "Free",
"monthly_cost": "Free"
}
],
"description": "The world’s largest marketing automation platform.",
"installs": 150981,
"installed_at": "2018-08-21T00:00:00Z",
"platform": "shopify",
"vendor_name": "Mailchimp",
"vendor_url": "https://apps.shopify.com/partners/mailchimp",
"vendor_email": "shopify@mailchimp.com",
"review_count": 1147,
"average_rating": "4.1",
"icon_url": "https://apps.shopifycdn.com/listing_images/a06a73791138d8d7f2ef1d0d2c918e64/icon/3effee56b73b2af71488e18e74e25dd4.jpg?height=84\u0026quality=90\u0026width=84",
"removed_at": "2019-03-23T12:35:26.883266184Z",
"state": "Inactive",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.marsello",
"token": "marsello",
"name": "Marsello",
"categories": [
"marketing"
],
"app_store_url": "https://apps.shopify.com/marsello",
"plans": [
{
"name": "Free to install",
"monthly_cost": "Free to install"
}
],
"description": "Sell more with email, SMS, rewards programs, recommendations",
"installs": 3263,
"installed_at": "2019-04-09T00:00:00Z",
"platform": "shopify",
"vendor_name": "Marsello",
"vendor_url": "https://apps.shopify.com/partners/recovermycart",
"vendor_email": "help@marsello.com",
"review_count": 306,
"average_rating": "4.3",
"icon_url": "https://apps.shopifycdn.com/listing_images/01610b7070e1a444e4229cbef477e025/icon/573fd08d59e91ed2680ee1e390f76802.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.printful",
"token": "printful",
"name": "Printful: Print on Demand",
"categories": [
"finding and adding products"
],
"app_store_url": "https://apps.shopify.com/printful",
"plans": [
{
"name": "Free",
"monthly_cost": "Free"
}
],
"description": "Top-rated print on demand dropshipping \u0026 warehousing service",
"installs": 100827,
"installed_at": "2018-12-01T00:00:00Z",
"platform": "shopify",
"vendor_name": "Printful",
"vendor_url": "https://apps.shopify.com/partners/jansons",
"vendor_email": "support@printful.com",
"review_count": 3241,
"average_rating": "4.2",
"icon_url": "https://apps.shopifycdn.com/listing_images/3dd87416a3b1e12a9ef3604aaaaf4d1e/icon/308fcea4e28961cc48a158efbdb38f3d.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.printify",
"token": "printify",
"name": "Printify: Print on Demand",
"categories": [
"finding and adding products"
],
"app_store_url": "https://apps.shopify.com/printify",
"plans": [
{
"name": "Free",
"monthly_cost": "Free"
},
{
"name": "Premium",
"monthly_cost": "$29/month",
"monthly_cost_cents": 2900
}
],
"description": "Create and Sell Products, We Handle the Rest.",
"installs": 28625,
"installed_at": "2018-08-21T00:00:00Z",
"platform": "shopify",
"vendor_name": "Printify",
"vendor_url": "https://apps.shopify.com/partners/printifyapp",
"vendor_email": "merchantsupport@printify.com",
"review_count": 1555,
"average_rating": "4.2",
"icon_url": "https://apps.shopifycdn.com/listing_images/64dbf028e50bc736072a16e7d0f8a382/icon/daeda97b8170ac247f5f20df3b27ae67.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.product-reviews",
"token": "product-reviews",
"name": "Product Reviews",
"categories": [
"store design",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/product-reviews",
"plans": [
{
"name": "Free",
"monthly_cost": "Free"
}
],
"description": "The simplest way to share your customers' experiences.",
"installs": 205236,
"installed_at": "2018-08-21T00:00:00Z",
"platform": "shopify",
"vendor_name": "Shopify",
"vendor_url": "https://apps.shopify.com/partners/shopify",
"vendor_email": "support@shopify.com",
"review_count": 1404,
"average_rating": "3.7",
"icon_url": "https://apps.shopifycdn.com/listing_images/60fca9c7f3400ddd43004e94b1355691/icon/a8f35d011cf83221b2ad1f280ff8d236.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.product-reviews-addon",
"token": "product-reviews-addon",
"name": "Stamped.io Product Reviews UGC",
"categories": [
"store design",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/product-reviews-addon",
"plans": [
{
"name": "Lite",
"monthly_cost": "Free"
},
{
"name": "Basic",
"monthly_cost": "$23/month",
"monthly_cost_cents": 2300
},
{
"name": "Premium",
"monthly_cost": "$49/month",
"monthly_cost_cents": 4900
},
{
"name": "Business",
"monthly_cost": "$119/month",
"monthly_cost_cents": 11900
}
],
"description": "Collect and showcase reviews to build trust and boost sales",
"installs": 34261,
"installed_at": "2018-08-21T00:00:00Z",
"platform": "shopify",
"vendor_name": "Stamped.io",
"vendor_url": "https://apps.shopify.com/partners/shopry",
"vendor_email": "hello@stamped.io",
"review_count": 4610,
"average_rating": "4.9",
"icon_url": "https://apps.shopifycdn.com/listing_images/00f756e9e94e8c3cfb14266ae483d0f0/icon/164b288733de2c8d52f20918016cd9b2.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.spod-spreadshirt-print-on-demand",
"token": "spod-spreadshirt-print-on-demand",
"name": "SPOD ‑ Print‑on‑Demand",
"categories": [
"finding and adding products",
"store design"
],
"app_store_url": "https://apps.shopify.com/spod-spreadshirt-print-on-demand",
"plans": [
{
"name": "Free",
"monthly_cost": "Free"
}
],
"description": "Pandemic-Proof. 48 Hours Flat. EU \u0026 US Production.",
"installs": 5684,
"installed_at": "2020-11-27T00:00:00Z",
"platform": "shopify",
"vendor_name": "SPOD - Spreadshirt Print on Demand",
"vendor_url": "https://apps.shopify.com/partners/spod",
"vendor_email": "support@spod.com",
"review_count": 512,
"average_rating": "4.4",
"icon_url": "https://apps.shopifycdn.com/listing_images/c41ce7737a754fcbdf6fb6d1360e7e9d/icon/e8d6f184abd77088e8e8779f8689c54d.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-12-06T00:00:00"
},
{
"id": "1.stamped-io-loyalty-rewards",
"token": "stamped-io-loyalty-rewards",
"name": "Stamped.io Loyalty \u0026 Rewards",
"categories": [
"marketing"
],
"app_store_url": "https://apps.shopify.com/stamped-io-loyalty-rewards",
"plans": [
{
"name": "Lite",
"monthly_cost": "Free"
},
{
"name": "Premium",
"monthly_cost": "$29/month",
"monthly_cost_cents": 2900
},
{
"name": "Business",
"monthly_cost": "$119/month",
"monthly_cost_cents": 11900
},
{
"name": "Professional",
"monthly_cost": "$399/month",
"monthly_cost_cents": 39900
}
],
"description": "Boost customer engagement \u0026 retention with a loyalty program",
"installs": 27541,
"installed_at": "2020-04-15T00:00:00Z",
"platform": "shopify",
"vendor_name": "Stamped.io",
"vendor_url": "https://apps.shopify.com/partners/shopry",
"vendor_email": "hello@stamped.io",
"review_count": 41,
"average_rating": "4.7",
"icon_url": "https://apps.shopifycdn.com/listing_images/3e50e932c5ec0997c60cd4f3f0662bf7/icon/f122004a018e716c19432871c7c2f38f.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2020-04-10T00:00:00"
},
{
"id": "1.web-push-notification",
"token": "web-push-notification",
"name": "Smart Push Marketing ‑ WebPush",
"categories": [
"store design",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/web-push-notification",
"plans": [
{
"name": "Free",
"monthly_cost": "Free"
}
],
"description": "Holiday sales abandoned carts recovery via push notification",
"installs": 4743,
"installed_at": "2020-11-19T00:00:00Z",
"platform": "shopify",
"vendor_name": "Hextom",
"vendor_url": "https://apps.shopify.com/partners/hextom",
"vendor_email": "help@hextom.com",
"review_count": 1478,
"average_rating": "4.7",
"icon_url": "https://apps.shopifycdn.com/listing_images/fec74ce17a5efaa984226d7f9273f259/icon/26b3d96ac232704952ef3a85354c0351.jpg?height=84\u0026quality=90\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
}
],
"avg_price": 2713,
"categories": [
"/Smoking \u0026 Vaping"
],
"country_code": "US",
"currency_code": "USD",
"employee_count": 17,
"estimated_sales": 3974898,
"contact_info": [
{
"company": true,
"followers": 3974,
"followers_30d": -26,
"followers_90d": -58,
"source": "/",
"type": "twitter",
"value": "https://twitter.com/vapescom"
},
{
"company": true,
"followers": 16162,
"followers_30d": -56,
"followers_90d": -152,
"source": "/",
"type": "instagram",
"value": "https://instagram.com/vapescom"
},
{
"company": true,
"source": "/",
"type": "snapchat",
"value": "https://www.snapchat.com/add/vapescom"
},
{
"company": true,
"followers": 35734,
"followers_90d": -245,
"source": "/pages/newsletter",
"type": "facebook",
"value": "https://facebook.com/vapescom"
},
{
"company": true,
"followers": 1405,
"followers_30d": 8,
"followers_90d": 30,
"source": "/pages/newsletter",
"type": "pinterest",
"value": "https://www.pinterest.com/vapescom"
},
{
"company": true,
"followers": 528,
"source": "/pages/newsletter",
"type": "youtube",
"value": "https://www.youtube.com/vapescom"
},
{
"company": true,
"source": "/pages/contact",
"type": "phone",
"value": "612-200-1962"
},
{
"company": true,
"source": "/pages/contact",
"type": "phone",
"value": "612-254-2649"
},
{
"company": true,
"type": "linkedin",
"value": "https://www.linkedin.com/company/vapes"
}
],
"language_code": "en",
"last_plan_change_at": "2019-07-18T00:00:00",
"latitude": 37.09024,
"location": "United States",
"longitude": -95.712891,
"merchant_name": "VAPES E",
"description": "Shop online for e-cigarettes, mods, vape pens, atomizers, dry herb vaporizers, oil/wax pens, enails, ehookah, accessories and USA made e-juice/liquid.",
"monthly_app_spend": 999,
"name": "www.vapes.com",
"plan": "Shopify Plus",
"platform_rank": 1856,
"product_count": 1608,
"platform": "shopify",
"rank": 4393,
"state": "Active",
"tags": [
"Dropshipper",
"Print on Demand"
],
"technologies": [
{
"name": "CM Commerce",
"description": "CM Commerce takes the guesswork and time investment out of email marketing.",
"installed_at": "2020-04-06T00:00:00Z",
"installs": 1301
},
{
"name": "Google Analytics",
"description": "Google Analytics gives you the tools you need to better understand your customers. You can then use those business insights to take action, such as improving your website, creating tailored audience lists, and more.",
"installed_at": "2019-12-20T00:00:00Z",
"installs": 1197138
},
{
"name": "Printful",
"description": "Easy print-on-demand drop shipping and fulfillment warehouse services.",
"installed_at": "2020-12-05T00:00:00Z",
"installs": 100745
},
{
"name": "Sezzle",
"description": "Sezzles lets you buy from your favorite stores today, and split up the cost into four interest-free payments.",
"installed_at": "2020-12-05T00:00:00Z",
"installs": 23069
},
{
"name": "ShareASale",
"description": "A leading provider of performance marketing solutions for the past 20 years.",
"installed_at": "2020-09-30T00:00:00Z",
"installs": 4951
},
{
"name": "Stamped",
"description": "Stamped.io is the best software platform to collect reviews and user-generated content for your business.",
"installed_at": "2020-11-10T00:00:00Z",
"installs": 35389
}
],
"theme": {
"name": "debut",
"style": "Light",
"vendor": "Shopify",
"version": "Unknown"
},
"title": "VAPES E-Cigs, E-juice, Wax Vape Pens, Herbal Vaporizers",
"vendor_count": 190,
"created_at": "2016-12-30T00:00:00",
"last_updated_at": "2021-01-18T00:00:00"
}
}
List Domains
Returns a list of Domains. The request options documented below can be used to constrain the results to Domains matching a specific criteria. Without any options, this endpoint will list all Domains.
By default, 50 Domains are returned in a single request. The cursor request option can be used to paginate through results.
Request Options
Filters the results to Domains matching the Advanced Search.
The cursor request option is used to paginate through search results. Each response that has more results returns a next_cursor attribute. Pass this value to the cursor request option to retrieve the next page of results.
Note that the cursor value is only valid until the next weekly data update. An error will be returned if you obtain a cursor prior to a weekly data update and then attempt to use it after the weekly update.
Use cursor=all to retrieve all Domains matching the provided filters in a single request. This can also be done using the Export Domains endpoint (which is slightly faster) however you may prefer to use this endpoint so that all results are returned in a single JSON document.
When using cursor=all, results are generated asynchronously and the initial request will immediately return an HTTP 202 response. The client should poll the same url, approximately once every 5 seconds, until an HTTP 200 response is returned (along with results).
When an HTTP 202 response is returned, the response body may include keys indicating the progress of the export.
{ "progress": 10000, "total": 750000 }
Filters the results to Domains that have the given app installed. Apps are identified by combining the App platform and the App name (e.g., "shopify.messenger").
Multiple values must be comma-separated.
The boolean operation to apply to values provided in the f:an request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that are in the given administrative_area_level_1. Must be used with the f:cc filter.
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:administrative_area_level_1:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:administrative_area_level_1 request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that have alexa_rank greater than or equal to the provided value.
Filters the results to Domains that have alexa_rank less than or equal to the provided value.
Filters the results to Domains that installed the given App identifier within time ranges specified by f:app_installed_at:min and f:app_installed_at:max (at least one of min and max must be provided).
The minimum date for f:app_installed_at. If left blank, the response includes all Domains that installed the App before the provided maximum date (in f:app_installed_at:max).
The maximum date for f:app_installed_at. If left blank, the response includes all Domains that installed the App after the provided minimum date (in f:app_installed_at:min).
Filters the results to Domains that uninstalled the given App identifier within time ranges specified by f:app_uninstalled_at:min and f:app_uninstalled_at:max (at least one of min and max must be provided).
The minimum date for f:app_uninstalled_at. If left blank, the response includes all Domains that uninstalled the App before the provided maximum date (in f:app_uninstalled_at:max).
The maximum date for f:app_uninstalled_at. If left blank, the response includes all Domains that uninstalled the App after the provided minimum date (in f:app_uninstalled_at:min).
Filters the results to Domains that have average product price greater than or equal to the provided integer value.
Note: this value is the minor unit of the Domain's currency (e.g., cents of USD). So use the value 150 to represent $1.50.
Filters the results to Domains that have average product price less than or equal to the provided integer value.
Note: this value is the minor unit of the Domain's currency (e.g., cents of USD). So use the value 150 to represent $1.50.
Filters the results to Domains that have the given category.
Multiple values must be comma-separated.
The boolean operation to apply to values provided in the f:cat request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that are in the given country code.
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:cc:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:cc request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that are in the given city. Must be used with the f:cc and f:administrative_area_level_1 filters.
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:city:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:city request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that were created in the given month (identified using YYYY-MM format).
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:cratyyyymm:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:cratyyyymm request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that were created in the given week (identified using YYYY-MM-DD format). Note that our data is updated weekly and the weekly creation date is always grouped to a Friday. If you query with a value that is not a Friday, we will automatically map the value provided to the previous Friday. (e.g., 2019-04-22 is be mapped to 2019-04-19).
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:cratyyyymmdd:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:cratyyyymmdd request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains selling with the given currency code.
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:curr:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:curr request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that are in the given state.
Valid values are:
- Active
- Inactive
- Password Protected
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:ds:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:ds request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that have employee count greater than or equal to the provided integer value.
Filters the results to Domains that have employee count less than or equal to the provided integer value.
Filters the results to Domains that have estimated monthly sales greater than or equal to the provided integer value.
Note: this value is in cents of USD. So use the value 150 to represent $1.50.
Filters the results to Domains that have estimated monthly sales less than or equal to the provided integer value.
Note: this value is in cents of USD. So use the value 150 to represent $1.50.
Filters the results to Domains that have a minimum number of Facebook followers.
Filters the results to Domains that have a maximum number of Facebook followers.
Filters the results to Domains that have added at least the given number of Facebook followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given number of Facebook followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at least the given percentage of Facebook followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given percentage of Facebook followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have the given features enabled.
Valid values are:
- Amazon Pay
- Apple Pay
- Google Pay
- PayPal
- Shopify Pay
Multiple values must be comma-separated.
The boolean operation to apply to values provided in the f:features request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that have a minimum number of Instagram followers.
Filters the results to Domains that have a maximum number of Instagram followers.
Filters the results to Domains that have added at least the given number of Instagram followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given number of Instagram followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at least the given percentage of Instagram followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given percentage of Instagram followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters results based on Domain type. This is a boolean field. Use true to return only Domains using a provider domain name (e.g., merchant.myshopify.com). Use false to return only Domains using a custom domain (e.g., shop.merchant.com).
The boolean operation to apply to values provided in the f:ismy request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters results to Domains that have contact information of the given type(s).
Valid values are:
- phone
- snapchat
- youtube
Multiple values must be comma-separated.
The boolean operation to apply to values provided in the f:it request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains with content in the given language code. (e.g., "en")
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:lang:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:lang request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that changed e-commerce platform pricing plans on or after the provided date. Often used with the f:plan request option.
Filters the results to Domains that changed e-commerce platform pricing plans on or before the provided date. Often used with the f:plan request option.
Filters the results to Domains that changed from the provided e-commerce platform.
Valid values are:
- woocommerce
- shopify
- wix
- prestashop
- magento
- bigcartel
- square
- ecwid
- opencart
- bigcommerce
- base
- squarespace
- storesjp
- shopline
- volusion
- 3dcart
- salla
- lightspeed
- hcl
- demandware
- sap
- nop
- webflow
- shopmatic
- spreecommerce
- miva
- shopware
- expandcart
- atg
- zid
- easystore
- oracle
- ecomz
- shopcada
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:p:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:last_platform request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that changed e-commerce platforms on or after the provided date.
Filters the results to Domains that changed e-commerce platforms on or before the provided date.
Filters the results to Domains that have monthly app spend greater than or equal to the provided integer value.
Note: this value is in cents of USD. So use the value 150 to represent $1.50.
Filters the results to Domains that have monthly app spend less than or equal to the provided integer value.
Note: this value is in cents of USD. So use the value 150 to represent $1.50.
Filters the results to Domains that have given Magento major version.
Valid values are:
- 1
- 2
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:mmv:op to "or" if you provide multiple values.
Consider using the f:mv request option if you need to filter on the full Magento version.
The boolean operation to apply to values provided in the f:mmv request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that have given Magento version.
Examples of valid values are:
- 1.7.0.2
- 2.3
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:mv:op to "or" if you provide multiple values.
Consider using the f:mmv request option if you only need to filter on the Magento major version.
The boolean operation to apply to values provided in the f:mv request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that have a minimum number of Pinterest followers.
Filters the results to Domains that have a maximum number of Pinterest followers.
Filters the results to Domains that have added at least the given number of Pinterest followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given number of Pinterest followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at least the given percentage of Pinterest followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given percentage of Pinterest followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains using the given pricing plan.
Examples of valid values are:
- Shopify Plus
- Professional
- Performance
- Premium
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:plan:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:plan request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that are on the given e-commerce platform.
Valid values are:
- woocommerce
- shopify
- wix
- prestashop
- magento
- bigcartel
- square
- ecwid
- opencart
- bigcommerce
- base
- squarespace
- storesjp
- shopline
- volusion
- 3dcart
- salla
- lightspeed
- hcl
- demandware
- sap
- nop
- webflow
- shopmatic
- spreecommerce
- miva
- shopware
- expandcart
- atg
- zid
- easystore
- oracle
- ecomz
- shopcada
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:p:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:p request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that have product count greater than or equal to the provided integer value.
Filters the results to Domains that have product count less than or equal to the provided integer value.
Filters the results to Domains that have platform rank greater than or equal to the provided integer value.
Filters the results to Domains that have platform rank less than or equal to the provided integer value.
Filters the results to Domains that have rank greater than or equal to the provided integer value.
Filters the results to Domains that have rank less than or equal to the provided integer value.
Filters the results to Domains that are in the given region (e.g., "Europe").
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:reg:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:reg request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that are in the given subregion (e.g., "Northern Europe").
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:sreg:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:sreg request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that have the given tags (e.g., "Print on Demand").
Multiple values must be comma-separated.
The boolean operation to apply to values provided in the f:tags request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that have the given technology installed (e.g., "Facebook Pixel").
Multiple values must be comma-separated.
The boolean operation to apply to values provided in the f:tech request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that installed the given technology within time ranges specified by f:tech_installed_at:min and f:tech_installed_at:max (at least one of min and max must be provided).
The minimum date for f:tech_installed_at. If left blank, the response includes all Domains that installed the technology before the provided maximum date (in f:tech_installed_at:max).
The maximum date for f:tech_installed_at. If left blank, the response includes all Domains that installed the technology after the provided minimum date (in f:tech_installed_at:min).
Filters the results to Domains that uninstalled the given technology within time ranges specified by f:tech_uninstalled_at:min and f:tech_uninstalled_at:max (at least one of min and max must be provided).
The minimum date for f:tech_uninstalled_at. If left blank, the response includes all Domains that uninstalled the technology before the provided maximum date (in f:tech_uninstalled_at:max).
The maximum date for f:tech_uninstalled_at. If left blank, the response includes all Domains that uninstalled the technology after the provided minimum date (in f:tech_uninstalled_at:min).
Filters the results to Domains that are in the given top-level domain (e.g., "net").
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:tld:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:tld request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains with the given Theme name.
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:tn:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:tn request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains with the given Theme style.
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:ts:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:ts request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains with the given Theme vendor name.
Multiple values must be comma-separated. This field is mutually exclusive, so be sure to set f:tvn:op to "or" if you provide multiple values.
The boolean operation to apply to values provided in the f:tvn request option (if multiple values are provided).
Possible values:
- and (default): Returns Domains matching all provided values.
- or: Returns Domains matching any provided value.
- not: Returns Domains that do not match any of the provided values.
For more complex queries, see Advanced Search.
Filters the results to Domains that have a minimum number of Twitter followers.
Filters the results to Domains that have a maximum number of Twitter followers.
Filters the results to Domains that have added at least the given number of Twitter followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given number of Twitter followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at least the given percentage of Twitter followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given percentage of Twitter followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have a minimum number of YouTube followers.
Filters the results to Domains that have a maximum number of YouTube followers.
Filters the results to Domains that have added at least the given number of YouTube followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given number of YouTube followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at least the given percentage of YouTube followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
Filters the results to Domains that have added at most the given percentage of YouTube followers in the last 30 days. Note that values can be negative to find Domains that with shrinking follower counts.
A comma-separated list of fields to include in the response. All fields are returned if left blank. If you only need a subset of fields in the response, it is recommended to use this request parameter since it can have a significant impact on response time.
Nested fields can be specified using a period to separate the field name and the nested field name. For instance,
using fields=name,apps.name
would return the name field from each Domain and the name field for all apps
on each Domain.
The number of Domains to return in a single query. Default: 50, Max: 5000.
Changes the sort order. Multiple fields can be provided (comma-separated). Prefix fields with a minus sign (-) to denote descending sort order.
Valid fields are:
- app_install_count
- average_product_price
- created_at
- estimated_sales
- facebook_followers
- instagram_followers
- monthly_app_spend
- pinterest_followers
- product_count
- theme_cost
- twitter_followers
Filters Domains based on a text query. (e.g., a query for "vape" will return only Domains that matching the word "vape" in the Domain name, merchant_name or description fields).
Example Request
$ curl -H 'Authorization: Bearer your.api.key' 'https://storeleads.app/json/api/v1/all/domain?f:cc=US&f:cratyyyymm=2018-11&page_size=2'
Search requests can also be triggered via HTTP POST.
$ curl -H 'Authorization: Bearer your.api.key' -H "Content-Type: application/json" -X POST -d '{"page_size":2,"f:cc":"US","f:cratyyyymm":"2018-11"}' 'https://storeleads.app/json/api/v1/all/domain'
Example Response
{
"domains": [
{
"alexa_rank": 77867,
"aliases": [
"www.shopcuup.com"
],
"apps": [
{
"id": "1.foursixty",
"token": "foursixty",
"name": "Shoppable Instagram \u0026 UGC.",
"categories": [
"store design",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/foursixty",
"plans": [
{
"name": "Core",
"monthly_cost": "$50/month",
"monthly_cost_cents": 5000
},
{
"name": "Complete",
"monthly_cost": "$300/month",
"monthly_cost_cents": 30000
}
],
"description": "Shoppable Instagram \u0026 UGC. Rights Mgmt. Influencer Tracking.",
"installs": 2310,
"installed_at": "2020-03-07T00:00:00Z",
"platform": "shopify",
"vendor_name": "Foursixty",
"vendor_url": "https://apps.shopify.com/partners/foursixty",
"vendor_email": "helpme@foursixty.com",
"review_count": 139,
"average_rating": "4.6",
"icon_url": "https://apps.shopifycdn.com/listing_images/43b401d6bc9caa05ff0f555ee2643f79/icon/454faebee6adeabe0bbac56b3b736081.jpg?height=84\u0026quality=90\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.gdpr-cookie-consent",
"token": "gdpr-cookie-consent",
"name": "GDPR Cookie Bar +ePrivacy Page",
"categories": [
"store design",
"trust and security"
],
"app_store_url": "https://apps.shopify.com/gdpr-cookie-consent",
"plans": [
{
"name": "Basic",
"monthly_cost": "Free"
},
{
"name": "Plus",
"monthly_cost": "$5.99/month",
"monthly_cost_cents": 599
},
{
"name": "Premium",
"monthly_cost": "$14.99/month",
"monthly_cost_cents": 1499
}
],
"description": "Free GDPR \u0026 CCPA Banner, Data Subject Reqs \u0026 Cookie Management",
"installs": 5458,
"installed_at": "2020-12-15T00:00:00Z",
"platform": "shopify",
"vendor_name": "Pandectes",
"vendor_url": "https://apps.shopify.com/partners/pandectes-io",
"vendor_email": "support@pandectes.io",
"review_count": 179,
"average_rating": "4.9",
"icon_url": "https://apps.shopifycdn.com/listing_images/3f0b68db732b6704928d685690b753c8/icon/d260e8cb01f5b6e3b83e16f61be5bf0c.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.helpdesk",
"token": "helpdesk",
"name": "Gorgias ‑ Live Chat \u0026 Helpdesk",
"categories": [
"customer support",
"productivity"
],
"app_store_url": "https://apps.shopify.com/helpdesk",
"plans": [
{
"name": "Basic plan",
"monthly_cost": "$60/month",
"monthly_cost_cents": 6000
},
{
"name": "Pro plan",
"monthly_cost": "$300/month",
"monthly_cost_cents": 30000
},
{
"name": "Advanced plan",
"monthly_cost": "$750/month",
"monthly_cost_cents": 75000
}
],
"description": "Centralize all your customer service channels in one place",
"installs": 3754,
"installed_at": "2020-11-27T00:00:00Z",
"platform": "shopify",
"vendor_name": "Gorgias",
"vendor_url": "https://apps.shopify.com/partners/gorgias",
"vendor_email": "support@gorgias.io",
"review_count": 423,
"average_rating": "4.7",
"icon_url": "https://apps.shopifycdn.com/listing_images/d783d0d0ded4ab7a13c20f47533819a3/icon/90bc59b2eff5562f5b9c1f482952fde5.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.klaviyo-email-marketing",
"token": "klaviyo-email-marketing",
"name": "Klaviyo: Email Marketing",
"categories": [
"store design",
"marketing",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/klaviyo-email-marketing",
"plans": [
{
"name": "Free to install",
"monthly_cost": "Free to install"
}
],
"description": "Marketing software built for your growth",
"installs": 144362,
"installed_at": "2019-12-27T00:00:00Z",
"platform": "shopify",
"vendor_name": "Klaviyo",
"vendor_url": "https://apps.shopify.com/partners/klaviyo",
"vendor_email": "success@klaviyo.com",
"review_count": 1184,
"average_rating": "4.3",
"icon_url": "https://apps.shopifycdn.com/listing_images/5edd9000b933a8fa88c152d1e498531f/icon/a4b94ea6ea6b897985ca70d45b2af29f.jpg?height=84\u0026quality=90\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.shogun",
"token": "shogun",
"name": "Shogun Landing Page Builder",
"categories": [
"store design",
"marketing"
],
"app_store_url": "https://apps.shopify.com/shogun",
"plans": [
{
"name": "Build",
"monthly_cost": "$39/month",
"monthly_cost_cents": 3900
},
{
"name": "Measure",
"monthly_cost": "$99/month",
"monthly_cost_cents": 9900
},
{
"name": "Optimize",
"monthly_cost": "$149/month",
"monthly_cost_cents": 14900
}
],
"description": "Build Custom Product Pages, Blog Posts, FAQ Pages \u0026 Funnels.",
"installs": 24060,
"installed_at": "2020-05-19T00:00:00Z",
"platform": "shopify",
"vendor_name": "Shogun Labs, Inc.",
"vendor_url": "https://apps.shopify.com/partners/shogun",
"vendor_email": "support@getshogun.com",
"review_count": 2301,
"average_rating": "4.8",
"icon_url": "https://apps.shopifycdn.com/listing_images/0ca2c1526ec07b9f52021bd42651b1fd/icon/6ea8814365f9c5184a6e5dd4cc1d2e81.jpg?height=84\u0026quality=90\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.yotpo-social-reviews",
"token": "yotpo-social-reviews",
"name": "Yotpo Product Reviews \u0026 Photos",
"categories": [
"store design",
"marketing",
"sales and conversion optimization"
],
"app_store_url": "https://apps.shopify.com/yotpo-social-reviews",
"plans": [
{
"name": "Free",
"monthly_cost": "Free"
},
{
"name": "Growth 50",
"monthly_cost": "$19/month",
"monthly_cost_cents": 1900
},
{
"name": "Growth 75",
"monthly_cost": "$29/month",
"monthly_cost_cents": 2900
},
{
"name": "Growth 100",
"monthly_cost": "$49/month",
"monthly_cost_cents": 4900
}
],
"description": "Collect product reviews, photo reviews, site reviews \u0026 ratings",
"installs": 15060,
"installed_at": "2018-11-02T00:00:00Z",
"platform": "shopify",
"vendor_name": "Yotpo",
"vendor_url": "https://apps.shopify.com/partners/yotpo",
"vendor_email": "shopify_support@yotpo.com",
"review_count": 2490,
"average_rating": "4.7",
"icon_url": "https://apps.shopifycdn.com/listing_images/659062da3dcade1068da9e28c3d120c5/icon/a87575f0d7c6c417a374133a92c7db3d.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
},
{
"id": "1.zendesk",
"token": "zendesk",
"name": "Zendesk",
"categories": [
"customer support"
],
"app_store_url": "https://apps.shopify.com/zendesk",
"plans": [
{
"name": "Free to install",
"monthly_cost": "Free to install"
}
],
"description": "Omnichannel customer service and engagement platform",
"installs": 15338,
"installed_at": "2019-04-11T00:00:00Z",
"platform": "shopify",
"vendor_name": "Zendesk",
"vendor_url": "https://apps.shopify.com/partners/zendesk_",
"vendor_email": "support@zendesk.com",
"review_count": 116,
"average_rating": "2.8",
"icon_url": "https://apps.shopifycdn.com/listing_images/d315fe70bcb98753afbe6aed7a9bffcd/icon/f4474f442f61557a8ec66a6c3bc363e6.png?height=84\u0026width=84",
"state": "Active",
"created_at": "2018-10-30T00:00:00"
}
],
"avg_price": 6323,
"categories": [
"/Apparel/Undergarments",
"/Apparel/Women's Clothing"
],
"country_code": "US",
"currency_code": "USD",
"employee_count": 18,
"estimated_sales": 13972050,
"features": [
"Returns Page",
"Tracking or Returns",
"Tracking Page"
],
"contact_info": [
{
"company": true,
"followers": 12655,
"followers_90d": 1558,
"source": "/",
"type": "facebook",
"value": "https://facebook.com/shopcuup"
},
{
"company": true,
"followers": 164214,
"followers_30d": 6181,
"followers_90d": 17334,
"source": "/",
"type": "instagram",
"value": "https://instagram.com/cuup"
},
{
"company": true,
"followers": 4226,
"followers_30d": 324,
"followers_90d": 979,
"source": "/",
"type": "pinterest",
"value": "https://www.pinterest.com/shop_cuup"
},
{
"company": true,
"followers": 110,
"followers_90d": 22,
"source": "/",
"type": "youtube",
"value": "https://www.youtube.com/channel/UCs7jXtqALi--sOZ8n0aPNdw"
},
{
"company": true,
"source": "/pages/about",
"type": "email",
"value": "support@shopcuup.com"
},
{
"company": true,
"source": "/pages/careers",
"type": "email",
"value": "careers@shopcuup.com"
},
{
"company": true,
"type": "linkedin",
"value": "https://www.linkedin.com/company/cuupinc"
}
],
"language_code": "en",
"last_plan_change_at": "2019-07-18T00:00:00",
"latitude": 40.7127753,
"location": "New York, NY, USA",
"city": "New York",
"administrative_area_level_1": "New York",
"longitude": -74.0059728,
"merchant_name": "CUUP",
"description": "Shop Bras that look and feel great in every size. Made from breathable fabrics that support without losing comfort or looks - because your boobs deserve better!",
"monthly_app_spend": 14900,
"name": "shopcuup.com",
"plan": "Shopify Plus",
"platform_rank": 81,
"product_count": 68,
"platform": "shopify",
"rank": 398,
"state": "Active",
"technologies": [
{
"name": "Afterpay",
"description": "Afterpay lets you buy what you want today, pay for it in four equal installments, interest-free.",
"installed_at": "2019-12-20T00:00:00Z",
"installs": 82160
},
{
"name": "Apple Pay",
"description": "Make contactless, secure purchases in stores, in apps, and on the web.",
"installed_at": "2020-11-10T00:00:00Z",
"installs": 869095
},
{
"name": "Google Tag Manager",
"description": "Google Tag Manager is a tag management system (TMS) that allows you to quickly and easily update tracking codes and related code fragments collectively known as tags on your website or mobile app.",
"installed_at": "2019-12-20T00:00:00Z",
"installs": 842617
},
{
"name": "Gorgias",
"description": "Gorgias provides flawless customer service for e-commerce stores",
"installed_at": "2020-11-27T00:00:00Z",
"installs": 3844
},
{
"name": "Hotjar",
"description": "Hotjar lets you see how visitors are really using your website, collect user feedback and turn more visitors into customers.",
"installed_at": "2020-02-28T00:00:00Z",
"installs": 71996
},
{
"name": "Klaviyo",
"description": "Klaviyo is the growth marketing platform built for online businesses.",
"installed_at": "2019-12-20T00:00:00Z",
"installs": 153774
},
{
"name": "LinkShare",
"description": "Discover new customers and increase conversions with the Rakuten LinkShare affiliate network.",
"installed_at": "2020-10-02T00:00:00Z",
"installs": 1730
},
{
"name": "PayPal Express Checkout",
"description": "Add PayPal to your existing checkout.",
"installed_at": "2020-11-07T00:00:00Z",
"installs": 874926
},
{
"name": "Shogun",
"description": "Build and optimize your pages with Shogun, the most powerful page building platform for eCommerce teams and agencies.",
"installed_at": "2020-05-19T00:00:00Z",
"installs": 25322
},
{
"name": "Talkable",
"description": "Talkable is a referral program software for eCommerce brands. Acquire high-value clients at a low cost, increase retention and grow revenue through targeted referral and loyalty programs.",
"installed_at": "2020-04-14T00:00:00Z",
"installs": 2246
},
{
"name": "Yotpo",
"description": "Yotpo accelerates growth with a full suite of solutions for customer reviews, visual marketing, loyalty programs, and referrals.",
"installed_at": "2019-12-20T00:00:00Z",
"installs": 36263
},
{
"name": "Zendesk",
"description": "Zendesk customer service and engagement products are powerful and flexible, and scale to meet the needs of any business.",
"installed_at": "2019-12-20T00:00:00Z",
"installs": 54536
}
],
"theme": {
"name": "lucid 2020-11-24 png to jpg \u0026 utm fix [mc] live",
"style": "Unknown",
"vendor": "Unknown",
"version": "Unknown"
},
"title": "CUUP | Shop Bras and Underwear Made to Fit",
"vendor_count": 1,
"created_at": "2018-11-02T00:00:00",
"last_updated_at": "2021-01-18T00:00:00"
},
{
"alexa_rank": 1136,
"country_code": "US",
"estimated_sales": 9313130,
"contact_info": [
{
"company": true,
"followers": 32280,
"source": "/",
"type": "facebook",
"value": "https://www.facebook.com/SonyRewards"
},
{
"company": true,
"source": "/faqs.html",
"type": "email",
"value": "members@members.sonyrewards.com"
},
{
"company": true,
"source": "/faqs.html",
"type": "phone",
"value": "1.888.715.7669"
},
{
"company": true,
"source": "/terms.html",
"type": "phone",
"value": "201-930-6161"
},
{
"company": true,
"source": "/terms.html",
"type": "phone",
"value": "877-718-7669"
},
{
"company": true,
"source": "/privacy.html",
"type": "phone",
"value": "1-800-299-3485"
},
{
"company": true,
"source": "/privacy.html",
"type": "phone",
"value": "1-800-314-1552"
}
],
"language_code": "en",
"latitude": 40.9445428,
"location": "Paramus, NJ 07652, USA",
"city": "Paramus",
"administrative_area_level_1": "New Jersey",
"longitude": -74.0754189,
"merchant_name": "Sony Rewards",
"description": "A rewards program for those who love entertainment, whether it’s the latest games, movies or tech, our mission is simple. Elevate your experiences. Sony Rewards",
"name": "www.rewards.sony.com",
"platform_rank": 118,
"product_count": 1028,
"platform": "demandware",
"rank": 422,
"state": "Active",
"technologies": [
{
"name": "CQuotient",
"description": "CQuotient is a personalization solution enabling leading retailers to deliver uniquely tailored messages to every customer at any interaction. CQuotient was acquired by Demandware and is now part of Salesforce Commerce Cloud.",
"installed_at": "2020-03-31T00:00:00Z",
"installs": 3217
},
{
"name": "reCAPTCHA",
"description": "reCAPTCHA is a free service that protects your website from spam and abuse. reCAPTCHA uses an advanced risk analysis engine and adaptive challenges to keep automated software from engaging in abusive activities on your site. It does this while letting your valid users pass through with ease.",
"installed_at": "2020-03-23T00:00:00Z",
"installs": 657293
}
],
"theme": {
"name": "Unknown",
"style": "Unknown",
"vendor": "Unknown",
"version": "Unknown"
},
"title": "Sony Rewards",
"created_at": "2018-11-09T00:00:00",
"last_updated_at": "2021-01-18T00:00:00"
}
],
"next_cursor": "5b22205c7530303031403d5c75303031385c75303030305c75303030305c75303030305c75303030305c75303030305c7530303030222c223135323330303134225d",
"total": 20707
}
Advanced Search for Domains
Sometimes you'll need to filter Domains in a more complex manner than is supported by the various f: request options supported by List Domains.
Example: Complex text queries
As an example, let's say that you want to return all Shopify Domains that match the query "kids" and also match any of the following words: "footwear", "shoes" and "boots". Further, you want to filter out any results that match "ski" or "ballet" because you're not interested in that kind of kids footwear.
This complex search expression can be expressed using the aq request option (which is analogous to Advanced Search in the UI).
The aq request option takes an array of search descriptors. Each descriptor must provide the following values:
- field: the name of the field
- value: the value to query against (multiple values must be comma-separated)
-
operator: the operation to apply when multiple values are provided
- and (default): Returns Domains matching all provided values
- or: Returns Domains matching any of the provided values
- nand: Returns Domains that do not match all of the provided values
- nor: Returns Domains that do not match any of the provided values
Our example query would be represented as:
[ { "field": "q", "value": "kids"}, { "field": "q", "value": "footwear shoes boots", "operator": "or"}, { "field": "q", "value": "ski ballet", "operator": "nor"} ]
Example Request
The example advanced query above can be executed using the following HTTP POST.
$ curl -H 'Authorization: Bearer your.api.key' -H "Content-Type: application/json" -X POST -d '{"aq":[{"field":"q","value":"kids"},{"field":"q","value":"footwear shoes boots","operator":"or"},{ "field":"q","value":"ski ballet","operator":"nor"}]}' 'https://storeleads.app/json/api/v1/all/domain'
Filters expressed with the aq request option can be combined with other filter request options.
Supported Fields
Advanced queries can be run against the following fields.
Export Domains
Returns all Domains matching the request options. Unlike List Domains, this endpoint does not paginate, instead it returns all Domains matching the query in a single response.
Note you may use the cursor request option of the List Domains endpoint (by passing cursor=all) to return all Domains matching a query. Unlike the Export Domains endpoint, The List Domains endpoint returns all results in a single JSON document (see below for details) and may be easier to use as a result. However, List Domains is much slower so Export Domains should be preferred where possible.
Request Options
Supports the same request options as List Domains.
Example Request
$ curl -H 'Authorization: Bearer your.api.key' 'https://storeleads.app/json/api/v1/all/domain-export?f:p=shopify&f:cc=US&f:cratyyyymm=2018-11'
Export requests can also be triggered via HTTP POST.
$ curl -H 'Authorization: Bearer your.api.key' -H "Content-Type: application/json" -X POST -d '{"f:cc":"US","f:cratyyyymm":"2018-11","f:p":"shopify"}' 'https://storeleads.app/json/api/v1/all/domain-export'
Example Response
The export endpoint streams the response as results are generated. Each line is a separate JSON document so be sure to parse the response one line at a time. The resulting domains are grouped into "chunks" which can arrived out-of-order. Each chunk includes an ordinal so that out-of-order results can be sorted if order is significant to your use case.
The first JSON document in the response contains meta information describing the response. It includes the following attributes:
Subsequent documents contain the chunk ordinal and a list of domains within the chunk.
{ "chunk_size": 25000, "expected_chunks": 2, "domains": 29830 } { "chunk": 0, "domains": [ {"name": "thaikila.com", ... } ] } { "chunk": 1, "domains": [ {"name": "lidetailers.com", ... } ] }
Error Handling
Since the export endpoint is streamed, we cannot set the HTTP status code (which is set in the HTTP headers at the beginning on the response) when an error occurs in the middle of the stream. As a result, clients need additional error checking when using the export endpoint.
If an error occurs in the middle of a stream, a JSON document describing that error is written to the stream.
{ "chunk_size": 25000, "expected_chunks": 2, "domains": 29830 } { "chunk": 0, "domains": [ {"name": "thaikila.com", ... } ] } { "error": "error description" }
Clients should always verify that the response contained the expected number of chunks (by comparing the number of chunks received against the expected_chunks value in the meta JSON document).
Best Practices
Networks are unreliable and connections often timeout if left open too long. To minimize the likelihood of networking errors, we suggest downloading the results of the export endpoint as quickly as possible. This means that you should do minimal processing of the results until the entire response has been read allowing the TCP connection to close. Depending on the RAM available on your servers and the number of domains that you are retrieving, you may be able to read the entire response into memory. If that is not an option, consider writing the response to a temporary file on disk instead. Then, run whatever processing is necessary on the persisted results.
Products
Product objects represent a product for sale at a Domain.
List Products for a Domain
Returns a list of Products available for sale at a Domain.
Example Request
$ curl -H 'Authorization: Bearer your.api.key' 'https://storeleads.app/json/api/v1/all/product/domain/www.sensibo.com'
Example Response
{
"products": [],
"total": 0
}
Tools
Postman
Postman is an app for easy RESTful API exploration and testing. You can use Postman to test API calls without having to write code.
To help get you started, you can review the Store Leads API in Postman. Then, follow the steps below to test the API interactively using the Postman app.
- If you don't already have it installed, visit https://www.getpostman.com/ and install the Postman client.
- Click the Run in Postman button below to open Postman and import the Store Leads API Postman collection.
Swagger API Specification
The Store Leads API specification is available in Swagger/OpenAPI format.
Supported Languages
We haven't published any SDKs yet but the API specification can be used to automatically generate an SDK for a specific programming language. To do so, you'll need to have a working version of swagger-codegen installed and follow the instructions provided by swagger-codegen.
Webhooks
To be notified as soon as new data is added to the site (which happens weekly, normally on a Monday), you can configure webhooks under the Notifications tab of the Account page.