Integrations
Updated 2026-02-22
Use Mapstore storefront API endpoints in themes
What this article helps you do
Use Mapstore’s storefront API to fetch store data (locations, filters, details) from your theme or custom code. This is useful when you want to display stores in a custom layout or combine Mapstore data with other content.
Before you start
- Mapstore is installed and you have stores added
- You are comfortable editing Shopify theme code (Liquid or JavaScript)
- You understand that API requests go through Shopify’s app proxy for security
Step-by-step instructions
1. Know where the API is
- Mapstore provides storefront API endpoints that your theme can call.
- Requests typically go through a Shopify app proxy URL (for example
/apps/mapstore/api/entities) so they are validated by Shopify.
2. Use the store list endpoint
- Call the appropriate endpoint to get a list of stores (optionally filtered by search, location, or tags).
- The response includes store details: name, address, coordinates, filters, contact info, and custom fields.
3. Use the response in your theme
- Parse the JSON response and use it in your Liquid templates or JavaScript.
- For example, you might render a custom store list, build a dropdown, or power a “Find near me” feature.
4. Respect rate limits and caching
- Avoid making too many requests in a short time.
- Cache responses when appropriate (e.g. store list doesn’t change every second).
5. Ensure requests go through the app proxy
- Use the correct proxy path so Shopify validates requests. See Understand Shopify app proxy requirements for Mapstore APIs.
How to verify it worked
- Add theme code that calls the Mapstore API.
- Load the page and confirm store data appears as expected.
- Check the browser console for errors if data doesn’t load.
Common issues and fixes
| Issue | Fix |
|---|---|
| 404 or request fails | Ensure you use the correct app proxy URL (for example /apps/mapstore/api/entities) and check that Mapstore’s app proxy is configured. |
| No stores returned | Verify you have active stores and that filters or parameters aren’t excluding all results. |
| CORS or security errors | API calls from the storefront must go through the app proxy; direct calls from the browser may be blocked. |