EveryData platform API
App Store API
Use App Store for App Store discovery results, app details, versions, ratings, and user reviews only through the 3 listed contracts, such as `search`, `profile`, `reviews`, because one view does not inherit another view’s reach.
For matching public results, use App Store action `search` with `keyword`; for the selected App Store record, switch to `profile` and `app_id`, rather than carrying parameters across.
- Endpoint
- POST /api/v1/social
- Capabilities
- 3
- Per 1,000
- $1.389
Available capabilities
Compare the App Store actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Use App Store | keyword | sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | app_id · name · url · bundle_id · developer · developer_id · developer_url · description · release_notes · version · price · currency · formatted_price · rating · rating_scale · rating_count · current_version_rating · current_version_rating_count · content_rating · category · icon_url · min_os · file_size_bytes · released_at · updated_at · platform |
profileApp details Use App Store | app_id | sort | Sync delivery | — | $1.39 per 1,000 requests | app_id · name · url · bundle_id · developer · developer_id · developer_url · description · release_notes · version · price · currency · formatted_price · rating · rating_scale · rating_count · current_version_rating · current_version_rating_count · content_rating · category · icon_url · min_os · file_size_bytes · released_at · updated_at · platform |
reviewsReviews App Store | app_id | sort | Sync delivery | Catalog values: defaultLimit=30, maxLimit=500. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · title · text · rating · rating_scale · author · app_version · helpful_count · posted_at · app_id · app_name · platform |
What does each App Store action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the App Store search parameters mean?
Use App Store search to discover App Store public results. Keyword discovery helps compare candidate iPhone and iPad software before choosing a listing. Pass sort and keyword to App Store search; returned objects expose current_version_rating, release_notes, platform, rating_count, content_rating, icon_url, min_os, version, description, developer_url, name, file_size_bytes, current_version_rating_count, developer, currency, updated_at, developer_id, app_id, bundle_id, url, rating, formatted_price, category, rating_scale, released_at, and price.
keywordRequired- Specifies App Store search terms, such as habit tracker or an application title, rather than a Bundle ID. Use the numeric app_id returned in the search results for subsequent app detail and review requests.
sortOptional- Specifies the App Store review display order, accepting newest for recent reviews or most_helpful for top reviews. The reviews action defaults to newest when omitted. This parameter does not filter app search ranks or star ratings, and search or profile requests should not rely on it to modify results.Allowed values:
most_helpfulnewest
What do the App Store profile parameters mean?
Use App Store profile to read one App Store public record. Storefront detail captures developer, release, compatibility, pricing, and rating metadata for one app. For App Store profile, supply app_id and sort; results include price, icon_url, rating_scale, developer_url, file_size_bytes, formatted_price, category, content_rating, current_version_rating, currency, release_notes, rating_count, bundle_id, platform, developer, released_at, url, developer_id, updated_at, min_os, description, version, app_id, rating, current_version_rating_count, and name.
app_idRequired- Specifies Apple's numeric app identifier, such as the digits after id in an application link. You can also pass a full App Store app URL, and the platform will extract the numeric ID. Do not pass a Bundle ID in com.example.app format.Apple: App Store Connect App InformationApple defines an app's Apple ID and Bundle ID separately; the Apple ID is also used in App Store app URLs.Checked
sortOptional- Specifies the App Store review display order, accepting newest for recent reviews or most_helpful for top reviews. The reviews action defaults to newest when omitted. This parameter does not filter app search ranks or star ratings, and search or profile requests should not rely on it to modify results.Allowed values:
most_helpfulnewest
What do the App Store reviews parameters mean?
App Store reviews treats App Store optional inputs as filters. App Store reviews takes app_id and sort and yields rating_scale, platform, id, helpful_count, text, app_name, app_version, posted_at, app_id, title, rating, and author.
app_idRequired- Specifies Apple's numeric app identifier, such as the digits after id in an application link. You can also pass a full App Store app URL, and the platform will extract the numeric ID. Do not pass a Bundle ID in com.example.app format.Apple: App Store Connect App InformationApple defines an app's Apple ID and Bundle ID separately; the Apple ID is also used in App Store app URLs.Checked
sortOptional- Specifies the App Store review display order, accepting newest for recent reviews or most_helpful for top reviews. The reviews action defaults to newest when omitted. This parameter does not filter app search ranks or star ratings, and search or profile requests should not rely on it to modify results.Allowed values:
most_helpfulnewest
How to use the App Store API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"app_store","action":"search","params":{"keyword":"<keyword>"}}'
App Store API questions
What can I retrieve with the App Store API?
Set platform to app_store. The current catalog lists search, app details, and reviews. These action names identify different App Store objects or views; they are not interchangeable search modes.
Which input starts a App Store `search` request?
Specifies App Store search terms, such as habit tracker or an application title, rather than a Bundle ID. Use the numeric app_id returned in the search results for subsequent app detail and review requests. Send it as keyword inside params.
Which fields can App Store `search` return?
Its declared schema includes app_id, name, bundle_id, and developer. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every App Store action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.