App & SaaS Reputation API
The App Reputation API enriches a mobile app as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary app_reputation endpoint resolves an app and returns store references, developer, match confidence and a reputation signal, with a rich variant and batch. It is built for app-intelligence, fraud and due-diligence workflows that need to vet an app without manual store lookups. One ReefAPI key, one shared credit pool, the standard envelope.
Three ways to identify an app, and how well each one resolves
The query parameter accepts three different kinds of input and the accuracy gap between them is large. Each row below is a real call, showing what entity.input_kind and entity.match_confidence came back and what the resolver actually landed on. The pattern is consistent: identifiers resolve exactly, names guess.
| What you send | input_kind and match | What it resolved to |
|---|---|---|
| a store URL or app id | store_url, match 'store-id', confidence 0.99 | The exact app, with the sibling store backfilled by name: Apple id 1232780281 plus Play id notion.id |
| A SaaS domain, e.g. datadoghq.com | domain, match 'domain', confidence 0.92 | The vendor's Play app, but resolved_name came back as 'DASH by Datadog', a different app by the same publisher |
| A bare name, e.g. Signal | name, match 'name-fuzzy', confidence 0.55 | 'Signal Detector Pro' by Lefan Co., a 5,000-install utility. Signal Private Messenger, with 1,077,004 Apple ratings, sat second in entity.candidates |
entity.candidates carries the same-name rivals the resolver considered, with a score for each. On a bare-name query it is the field that saves you: check that candidates[0] is the app you meant, and prefer a store URL or app id whenever the caller can supply one. country defaults to us and selects the store region for both Apple and Play.
Real request and response JSON
Captured from the indexed primary action, app_reputation, on .
{
"method": "POST",
"url": "https://api.reefapi.com/enrich-app/v1/app_reputation",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "https://apps.apple.com/us/app/notion/id1232780281",
"include": [
"stores"
]
}
}{
"ok": true,
"meta": {
"api": "enrich-app",
"endpoint": "app_reputation",
"mode": "basic",
"latency_ms": 4604.3,
"record_count": 1,
"bytes": 0,
"cache_hit": false,
"completeness_pct": 100,
"groups_run": [
"stores"
],
"subcalls": [
{
"api": "app-store",
"action": "appDetails",
"status": "ok",
"latency_ms": 1873.4
},
{
"api": "app-store",
"action": "search",
"status": "ok",
"latency_ms": 1254.7
},
{
"api": "app-store",
"action": "appDetails",
"status": "ok",
"latency_ms": 848
}
]
},
"data": {
"provenance": {
"reviews_sample": {
"status": "skipped",
"missing_reason": "skipped"
},
"trust": {
"status": "skipped",
"missing_reason": "skipped"
},
"developer": {
"status": "skipped",
"missing_reason": "skipped"
},
"status": {
"status": "skipped",
"missing_reason": "skipped"
},
"news": {
"status": "skipped",
"missing_reason": "skipped"
},
"launch": {
"status": "skipped",
"missing_reason": "skipped"
},
"entity": {
"status": "matched",
"engine": "app-store/search+google-search",
"match": "store-id",
"match_confidence": 0.99
},
"stores": {
"status": "matched",
"engine": "app-store"
}
},
"entity": {
"query": "https://apps.apple.com/us/app/notion/id[redacted-phone]",
"input_kind": "store_url",
"resolved_name": "Notion",
"match": "store-id",
"match_confidence": 0.99,
"domain": "notion.so",
"store_refs": [
{
"store": "apple",
"app_id": "[redacted-phone]",
"country": "us"
},
{
"store": "google_play",
"app_id": "notion.id",
"country": null
}
],
"developer": "Notion Labs, Incorporated",
"evidence": [
{
"kind": "store-appDetails",
"store": "apple",
"app_id": "[redacted-phone]",
"name": "Notion"
},
{
"kind": "store-backfill",
"store": "google_play",
"app_id": "notion.id",
"via": "name-exact",
"score": 0.6
}
],
"candidates": []
},
"stores": {
"apple": {
"app_id": "[redacted-phone]",
"name": "[redacted-name]",
"developer": "Notion Labs, Incorporated",
"rating": 4.77824,
"rating_count": 88621,
"review_count": null,
"current_version_score": 4.77824,
"histogram": {
"1": 2277,
"2": 853,
"3": 1568,
"4": 4850,
"5": 79073,
"total": 88621
},
"installs": null,
"price": 0,
"free": true,
"content_rating": "4+",
"categories": [
"Productivity",
"Business"
],
"version": "1.7.322",
"updated": "[redacted-phone]T07:10:18Z",
"url": "https://apps.apple.com/us/app/notion-notes-tasks-ai/id[redacted-phone]?uo=4"
},
"google_play": {
"app_id": "notion.id",
"name": "[redacted-name]",
"developer": "Notion Labs, Inc.",
"rating": 4.5734596,
"rating_count": 376083,
"review_count": 4775,
"current_version_score": null,
"histogram": {
"1": 18415,
"2": 6980,
"3": 14394,
"4": 36980,
"5": 299281
},
"installs": "10,000,000+",
"price": null,
"free": true,
"content_rating": "Everyone",
"categories": [
"Productivity"
],
"version": "0.6.4006",
"updated": "Jul 15, 2026",
"url": "https://play.google.com/store/apps/details?id=notion.id&hl=en&gl=us"
}
},
"summary": {
"reputation_index": 93.3,
"scale": "0-100 (normalized blend of matched 5-/10-star sources)",
"signals": [
{
"source": "store:apple",
"rating": 4.78,
"scale": 5,
"rating_count": 88621
},
{
"source": "store:google_play",
"rating": 4.57,
"scale": 5,
"rating_count": 376083
}
],
"sources_matched": [
"entity",
"stores"
],
"entity_confidence": 0.99,
"note": "reputation_index is a transparent average of the rating sources listed in `signals`, weighted by store popularity; it is null when no rating source matched (not zero)."
},
"coverage_note": "Source coverage varies by product type: a consumer (B2C) app is store-rich but often thin on Trustpilot/TrustRadius; a B2B SaaS is the reverse (store-empty, TrustRadius-rich). A null field means 'not found at that source', not zero. G2 and Capterra are intentionally OUT of scope."
}
}What the App & SaaS Reputation API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| app_reputation | name|store-URL|domain → entity-resolved app/SaaS reputation: store ratings + Trustpilot + GitHub + Product Hunt (basic) — see app_reputation_rich for the full fan-out (review samples + TrustRadius + status + news) | Support teams call app_reputation to get name|store-URL|domain → entity-resolved app/SaaS reputation. | query, country, stores, include, exclude, ... |
| app_reputation_rich | everything in app_reputation + a recent store-review sample + TrustRadius B2B reviews + vendor live status/incidents + recent news mentions | Reputation platforms call app_reputation_rich to get everything in app_reputation + a recent store-review sample + TrustRadius B2B reviews + vendo…. | query, country, stores, include, exclude, ... |
| batch | reputation for up to 10 apps/domains in one call (basic groups, cache-first, per-item ok/error) | Market researchers call batch to get reputation for up to 10 apps/domains in one call (basic groups, cache-first, per-item ok/error). | queries, country, stores, include, exclude |
Call app_reputation from your stack
curl -X POST https://api.reefapi.com/enrich-app/v1/app_reputation \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"https://apps.apple.com/us/app/notion/id1232780281","include":["stores"]}'import requests
r = requests.post(
"https://api.reefapi.com/enrich-app/v1/app_reputation",
headers={"x-api-key": REEF_KEY},
json={
"query": "https://apps.apple.com/us/app/notion/id1232780281",
"include": [
"stores"
]
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/enrich-app/v1/app_reputation", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "https://apps.apple.com/us/app/notion/id1232780281",
"include": [
"stores"
]
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.enrich-app.app_reputation with {"query":"https://apps.apple.com/us/app/notion/id1232780281","include":["stores"]}.Who uses this API and why
- Fraud tools call app_reputation to score an app before trusting it.
- App-intelligence products resolve an app name to its store listings and developer.
- Due-diligence workflows use batch to vet a portfolio of apps.
Questions developers ask before integrating
Why did a bare app name resolve to the wrong app?
Because name matching is fuzzy and the response says so with a low confidence rather than an error. A measured query of 'Signal' returned resolved_name 'Signal Detector Pro' at match_confidence 0.55, while 'Signal - Private Messenger' with over a million Apple ratings appeared as the second candidate. Anything at or near 0.55 should be treated as a guess. Pass a store URL, an app id or a domain, or read entity.candidates and re-query with the id you wanted.
resolved_name and the store block disagree. Which one describes the ratings?
The store block does. On a measured domain query for datadoghq.com, entity.resolved_name came back as 'DASH by Datadog' because that title scored highest in search, while entity.store_refs and the stores block both resolved to com.datadog.app, the main Datadog app, whose rating of 3.17 across 442 ratings is what the response actually reports. When you display a name next to a rating, take it from stores.apple.name or stores.google_play.name, not from resolved_name.
The store rating is 4.6 and Trustpilot is 2.3. Is one of them wrong?
Neither. They measure different populations, and the gap is normal enough that the engine reports both instead of averaging them away. A measured Notion lookup returned Apple 4.78 from 89,874 ratings, Play 4.58 from 386,180 ratings, and Trustpilot 2.3 from 428 reviews. Store ratings are dominated by satisfied everyday users, while a public review site collects complaints. summary.signals lists each source with its rating, scale and count so you can weight them yourself.
What is reputation_index and when is it null?
It is a 0-100 blend of exactly the sources listed in summary.signals, weighted by store popularity, and the payload documents that null means no rating source matched rather than a score of zero. Measured values: 79.7 for Notion across three sources, 49.7 for Datadog across two. Because the blend depends on which groups you ran, the same app scores differently under different include sets, so store the signals array alongside the index if you plan to compare over time.
Why is one of the two stores missing entirely?
Because coverage depends on what kind of product it is, and the response carries a coverage_note saying so. A consumer app is store-rich and often thin on review sites, while a B2B SaaS product is the reverse. A measured lookup on datadoghq.com returned a Google Play block and no Apple block at all, plus a Trustpilot match. G2 and Capterra are explicitly out of scope, so their absence is a stated limit and not a failed lookup.
Why do rating_count and review_count differ so much on Google Play?
They count different things. A measured Notion record returned rating_count 386,180 against review_count 4,845 on Play: the first is people who tapped a star, the second is people who wrote text. Apple returns rating_count 89,874 with review_count null, so do not expect the pair to be symmetrical across stores. installs is a bucketed string such as '10,000,000+' rather than a number, and Apple has no equivalent field.
Which groups can I ask for on the basic action?
stores, trust, developer and launch. reviews_sample, status and news are rich-only, and asking for one from app_reputation returns ok:false with INVALID_PARAM and the message 'include/exclude left no field groups to run'. Groups you did not ask for show up in provenance with status 'skipped'. A group that ran and found nothing looks different: a measured developer lookup returned status 'not_found' with a note that a missing GitHub presence is not a negative signal for a closed-source app.
How is this different from enrich-company on the same brand?
This engine is anchored on the product and its ratings: app store entries, review scores, launch presence and a reputation index. enrich-company is anchored on the domain and returns firmographics, WHOIS and DNS, hiring and tech stack, with no store data beyond a name-level apps group. They overlap on one field, the Trustpilot match, which both retrieve by domain. If your question is 'how do users rate this product', use this engine; if it is 'what is this company', use enrich-company.
What is the App & SaaS Reputation API?
App & SaaS Reputation API is a ReefAPI endpoint group for app & saas reputation It returns live JSON through POST requests under /enrich-app/v1.
Is the App & SaaS Reputation API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. App & SaaS Reputation calls use the same shared credit balance as every other ReefAPI engine.
Do I need an App & SaaS Reputation login or account?
No login to App & SaaS Reputation is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the App & SaaS Reputation data?
The page example is captured from a live app_reputation call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the App & SaaS Reputation API use?
App & SaaS Reputation actions currently cost 4-10 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call App & SaaS Reputation from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call enrich-app actions with the same key, credit pool and JSON envelope used by normal REST requests.