Installgraph API
The Installgraph API lists every Shopify store running an app, and any store's full app stack, as JSON. New accounts get up to 50 free credits.
Get started
- Start free with your work email and open the sign-in link we send. Your API key is on your dashboard.
- From code, send it as
Authorization: Bearer sfs_…. In a browser, add?key=sfs_…to the URL, and.csvto the path for a spreadsheet:https://api.installgraph.com/v1/apps/klaviyo/companies.csv?limit=10&key=sfs_… - Count first (free), then pull only the stores you need.
# Free: how many stores run the app
curl https://api.installgraph.com/v1/apps/signalpath/companies/count \
-H "Authorization: Bearer $INSTALLGRAPH_KEY"
# 1 credit per store: the stores themselves
curl https://api.installgraph.com/v1/apps/signalpath/companies \
-H "Authorization: Bearer $INSTALLGRAPH_KEY"Every response carries meta.creditsUsed and meta.creditsRemaining. Out of credits, the API answers 402 with machine-readable buy and Talk to us links.
Endpoints
| Endpoint | Returns | Credits |
|---|---|---|
Stores running an appGET /v1/apps/{slug}/companies | One row per store: domain, name, country, industry, order-value band, and the app's first and last-seen dates | 1 per store |
Count storesGET /v1/apps/{slug}/companies/count | How many stores match a filter | Free |
Domain lookupGET /v1/companies/{domain} | A store's full current app stack: apps, categories, first and last seen | 1 per store |
History add-oninclude=history, or GET /v1/events | Install and removal dates for a store's apps | +1 per store |
Pricing
- Packs from $50 for 500 credits to $1,000 for 40,000. Credits expire after 12 months.
- Charged only for stores returned. Counts are free; re-pulls of the same store within 7 days are free.
- Self-serve up to $1,000 or 40,000 stores per 30 days. Beyond that, talk to us.
Methodology: how we count installs
Installs are detected on live Shopify storefronts, each scanned weekly. A store counts as an active install if the app was detected on its most recent healthy scan.
Counts are recomputed daily from the latest scans. Each page is regenerated on a rolling 7-day cycle. Changes over 30 days and monthly history appear once the data has been tracked for that long.
Category membership follows each app's own Shopify listing. Switching counts a store that uninstalled one app and installed the other within 14 days.
Which apps have a page
An app gets a page once it is detected on at least 10 stores. Below that a count is too small to rank or profile, and a page without install data would only repeat the app's Shopify listing. Smaller apps still count towards category totals.
Scans read each store's homepage, so they see apps that run on the storefront. Apps that work only in the Shopify admin, at checkout or in other sales channels (order importers, accounting, inventory, checkout extensions) leave nothing there to detect, so they have no page however many stores use them. Apps that load only on product or cart pages are counted where they also load on the homepage.