# Installgraph

> Installgraph measures how many active Shopify stores run each Shopify app, how that changes month to month, and which apps stores switch between.

## Methodology (https://installgraph.com/docs#methodology)
<!-- Keep in step with METHODOLOGY in lib/site.ts. -->
- 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.
- Category membership follows each app's own Shopify listing.
- 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.

## API docs
- Quickstart and guide index: https://installgraph.com/docs/quickstart.md
- Every docs page in one file: https://installgraph.com/llms-full.txt
- OpenAPI 3.1 spec: https://installgraph.com/openapi.json
- Guides: [authentication](https://installgraph.com/docs/authentication.md), [credits](https://installgraph.com/docs/credits.md), [pagination](https://installgraph.com/docs/pagination.md), [rate limits](https://installgraph.com/docs/rate-limits.md), [errors](https://installgraph.com/docs/errors.md), [data model](https://installgraph.com/docs/data-model.md), [AI agents](https://installgraph.com/docs/agents.md)
- Endpoint reference: https://installgraph.com/docs/reference/{operation}.md, listed in docs/quickstart.md
- Any docs page as Markdown: append .md to its URL.

## API and pricing
The store-level data behind these pages, as JSON. Base URL https://api.installgraph.com, header "Authorization: Bearer sfs_…".
- API overview: https://installgraph.com/docs
- Get a key: sign up at https://installgraph.com/login (email link, no password); the key is on the dashboard at https://installgraph.com/account.
- Pricing: https://installgraph.com/pricing.md (1 credit = 1 store; change webhooks 10 credits per change delivered; packs from $50 for 500 credits; up to 50 free credits with a company email, none for webmail).
- How many stores run an app: GET /v1/apps/{slug}/companies/count (free)
- Stores running an app: GET /v1/apps/{slug}/companies (1 credit per store; filter by country, region, industry, order value)
- A store's full app stack: GET /v1/companies/{domain} (1 credit)
- App catalogue, to find an app's slug: GET /v1/apps (free)
- App popularity by category, region and industry: GET /v1/public/stats (free, no key)
- Talk to us (over $1,000 or 40,000 stores in 30 days, or the full dataset): https://installgraph.com/talk-to-us

## Pages
- Sitemap: https://installgraph.com/sitemap.xml
- App profiles: https://installgraph.com/apps/{app-handle}
- Category benchmarks: https://installgraph.com/categories/{category}/{subcategory}
- Categories: https://installgraph.com/categories