App Store API skill

Read public Apple App Store data as clean JSON. This App Store API skill returns app metadata, user reviews, keyword search results, ranked category lists and the storefronts an app is available in — the raw material for app store optimisation, competitor tracking and review analysis. Every endpoint here costs 1 credit, which makes it cheap to poll regularly.

This skill wraps 6 live App Store endpoints from the ScraperSocial API. Public data only, returned as clean JSON.

When to use this skill

• You are doing ASO work: checking how an app ranks for a keyword, or what its listing says.
• You need user reviews for an app to summarise sentiment or track a regression after a release.
• You are building a competitor watchlist and want category charts over time.
• A user pastes an App Store link and asks what the app is or how it is rated.

Do not use this skill when

• You need App Store Connect data — sales, installs, crash reports or anything tied to a developer account. This reads the public storefront only.
• You need Google Play data. Use the google-play-api skill; the two stores are separate endpoints with different app identifiers.
• You want download or revenue estimates. The API returns what the storefront publishes; it does not model private metrics.

Setup

export SCRAPERSOCIAL_KEY=sk_live_...   # https://scrapersocial.com/app/keys

Signing up at scrapersocial.com/signup includes 100 free credits, no card required.

Permissions and scope

These scripts do exactly three things and nothing else: read one environment variable (SCRAPERSOCIAL_KEY), send HTTPS requests to https://api.scrapersocial.com (the host is a constant in the code, not configurable), and print JSON. They run as node scripts/<name>.js with no other shell use, no file writes and no persistence. call_endpoint.js accepts only the 6 documented /v1/app_store/ paths in the table below and refuses anything else before a request is made.

Scripts

Every script also accepts --limit, --cursor, --fields, --format and --fresh. --limit is clamped to 50: above that the API returns an async job instead of data.

Example

node skills/app-store-api/scripts/app_search.js "meditation timer"

Every response uses the same envelope:

{ "data": {}, "meta": { "count": 20, "next_cursor": "..." }, "request_id": "a18e4ef88ad4b00b" }

meta appears on paginated endpoints only. Keep request_id — support traces calls with it.

Endpoints

Costs shown per item for paginated endpoints, per call otherwise. Failed calls are not charged.

FAQ

How do I get App Store reviews as JSON?

get_app_reviews.js takes the app handle and returns reviews at 1 credit per review. Use --limit to control volume and --cursor to page.

How do I find an app without knowing its ID?

Use app_search.js with a keyword, or get_app_list.js for ranked category lists. Both return handles you can pass to get_app_info.js.

Does this cover every country storefront?

get_locations.js returns the storefronts the API supports. App availability and rankings differ by storefront.

Is this an official Apple API?

No. ScraperSocial is independent and not affiliated with Apple. It returns publicly available App Store data only.

Links

• App Store data on ScraperSocial
• All 33 platform skills
• OpenAPI spec · llms.txt

Disclaimer

ScraperSocial is an independent product and is not affiliated with, endorsed by, or sponsored by any platform named in this repository. All product names, logos and brands are property of their respective owners. These skills return only publicly available data.