ica.se APIica.se ↗
Access ICA.se store data via API: retrieve store locations, contact info, opening hours, services, and current national weekly offers across all ICA stores.
curl -X GET 'https://api.parse.bot/scraper/aed99d34-6c53-4ce9-a5bb-3ff1e5566620/list_stores?skip=0&take=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve a paginated list of all ICA stores with basic info including store name, email address, phone number, address, opening hours, and services.
| Param | Type | Description |
|---|---|---|
| skip | integer | Number of stores to skip for pagination. |
| take | integer | Number of stores to return per page. |
{
"type": "object",
"fields": {
"data": "array of store objects with storeName, profile, phoneNumber, emailAddress, address, openingHours, services, storeId, accountNumber",
"status": "string, always 'success'"
},
"sample": {
"data": [
{
"address": {
"city": "Fjälkinge",
"county": "Skåne",
"street": "123 Main St",
"postalCode": "29167",
"coordinates": {
"coordinateX": "56.04189",
"coordinateY": "14.27984"
},
"municipality": "Kristianstad"
},
"profile": "Nära",
"storeId": "2527",
"services": [
"Apoteksombud",
"ATG ombud",
"Postombud"
],
"storeName": "ICA Nära A-Livs",
"phoneNumber": "+1 (555) 012-3456",
"emailAddress": "[email protected]",
"openingHours": {
"today": {
"label": "Torsdag",
"opens": "07:00",
"closes": "20:00",
"isClosed": false
},
"regulars": [
{
"label": "Måndag-fredag",
"opens": "07:00",
"closes": "20:00",
"isClosed": false
}
]
},
"accountNumber": "CRITICAL_PII_REDACTED"
}
],
"status": "success"
}
}About the ica.se API
The ICA.se API provides 3 endpoints covering Swedish ICA grocery store data, including store contact details, opening hours, and national weekly deals. The list_stores endpoint returns paginated results with fields like storeName, phoneNumber, emailAddress, address, openingHours, and services for every ICA location in the network. The get_national_offers endpoint delivers current promotional deals with pricing, validity dates, and product EAN codes.
Store Directory
The list_stores endpoint returns a paginated array of ICA store objects. Pagination is controlled via skip and take integer parameters, letting you walk through the full store catalog in chunks. Each store object includes storeName, storeId, accountNumber, phoneNumber, emailAddress, address, openingHours, and services. The storeId values returned here are the identifiers you pass into get_store_info.
Detailed Store Lookup
get_store_info accepts a comma-separated list of numeric store IDs (e.g. '2527,1235') and returns an extended store record for each. The response includes a stores array and an errorMessages array. Store records at this level add visiting address details, opening hour deviations (such as holiday adjustments), per-service opening hours, and store-specific URLs — fields not present in the basic list_stores response.
National Weekly Offers
get_national_offers takes no input parameters and returns the current set of national promotional deals active across ICA stores. Each offer object includes id, description, validFrom, validTo, category, details, discountValue, and one or more product EAN codes for cross-referencing against product catalogs. Offers are scoped nationally — they represent deals available broadly, not store-specific promotions.
- Build a store locator showing ICA locations with addresses and phone numbers pulled from
list_stores - Display weekly grocery deals in a meal-planning app using
validFrom,validTo, anddiscountValuefromget_national_offers - Sync ICA store opening hours into a calendar or scheduling tool using the
openingHoursand deviation fields fromget_store_info - Map available services per store location using the
servicesfield returned bylist_stores - Cross-reference national offer EAN codes against a product database to match discounted products
- Alert users to active promotions by monitoring
get_national_offersfor new entries or changedvalidFromdates - Build an internal ops dashboard showing contact details and opening hours for all ICA stores via
accountNumberandemailAddress
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ICA have an official public developer API?+
What does `get_store_info` return that `list_stores` does not?+
get_store_info adds opening hour deviations (e.g. holiday closures), per-service opening hours, visiting address breakdowns, and store-specific URLs. The basic list_stores endpoint returns general address and hours without those granular fields. You can query multiple stores in one call by passing a comma-separated string of storeId values.Are store-specific or local offers available through the API?+
get_national_offers, which reflect promotions available across all ICA stores. Store-level or regional promotions are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting store-specific offer data.Can I filter `get_national_offers` by category or product EAN?+
category field and product EAN codes, so filtering can be done client-side after fetching the full result set. You can fork this API on Parse and revise it to add server-side filtering parameters.Is there a limit to how many stores `list_stores` returns per call?+
skip and take parameters for pagination, so you control how many stores are returned per request and where in the list to start. There is no documented maximum for take, but fetching the full directory in pages is the intended pattern to avoid oversized responses.