# Prism Apps Lookup API (https://www.socialcrawl.dev/platforms/prism/apps-lookup)

> Resolves an app on both stores (by `title`, or directly via `google_play_id`/`app_store_id`), applies a title + developer match guard so two same-named-but-different apps aren't conflated, and folds the two listings into a cross-store comparison: per-store rating + install + price, the rating gap, and a match confidence. A clean no-match across stores is a valid (fully-charged) result; if neither store resolves the title → 404 + refund; both stores dead → full refund.

TL;DR: `GET /v1/prism/apps-lookup` costs 30 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `title` | no | The app title to resolve across both stores. |
| `google_play_id` | no | Google Play app id to anchor that store directly. |
| `app_store_id` | no | App Store app id to anchor that store directly. |
| `stores` | no | CSV subset of google_play,app_store (default both). |
| `country` | no | Store country. |
| `language` | no | Store language. |
| `match_threshold` | no | Title-similarity threshold for the cross-store match guard (0–1, default 0.6). |
| `include` | no | Optional leg toggles. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/apps-lookup" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl app store data API?

GET /v1/prism/apps-lookup resolves one app across Google Play and the App Store, matches the two listings by title, and compares them into a cross-store rating and listing report in a single call. You get both stores on one shared schema instead of hitting two APIs and reconciling the shapes yourself.

### How do I identify the app?

Supply exactly one anchor: title for a name lookup, google_play_id for a Play match, or app_store_id for an App Store match. From that anchor the composite resolves the app on each requested store, and match_threshold controls how strict the title matching is when the anchor is a name.

### What is in the cross-store report?

You get each store's rating, rating count, category, pricing, and listing metadata on one shared shape, plus a cross-store rating that blends the two. The stores, country, and language parameters pick which storefronts and locale to resolve, and include controls the supporting sections.

### How much does an apps-lookup call cost?

Each call is a flat 30 credits and returns one synchronous JSON response. If a strict majority of the store legs fail the call is partial-refunded, and if every leg fails the full 30 credits are refunded automatically. New accounts start with 100 free credits and no card.

### What if the app is only on one store?

That is a complete answer, not an error. The store where no match clears match_threshold comes back as null, and you still get the resolved store's full listing plus a cross-store rating from what did resolve. Honest nulls mean you always know which store had the app.

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get one app's data across Google Play and the App Store in a single API call?
- Which API matches an app by title across both stores into a cross-store rating?
- Is there an app store data API that returns listing metadata for both stores at once?