Merge pull request #192 from ddxv/main

Add blog post and clarify docs

Author: ddxv

README.md

@@ -22,6 +22,7 @@
 - **Company Intelligence** — See the top client apps for any mobile SDK or services company
   - Example: [Salesforce Clients](https://appgoblin.info/companies/salesforce.com)
   - Example: [AppsFlyer Top Apps](https://appgoblin.info/companies/appsflyer.com)
+  - Track quarterly app adoption and churn for a known company through added and lost app-change views
 
 - **Ad Tech Insights** — Tracks live ad campaigns and the ad tech domains apps communicate with
 
@@ -36,10 +37,10 @@
 - **App & game developers** looking to grow using free ASO tools
 - **Researchers & journalists** needing deep technical analysis across millions of apps
 - **Data scientists & marketers** needing reproducible app datasets for modeling, market mapping, and analysis
-- **Ad sales teams** prospecting clients by analyzing competitor app portfolios
+- **Ad sales teams** prospecting clients by analyzing competitor app portfolios and recent company churn
 - **Ad networks & DSPs** doing fraud detection
 - **DSPs** needing App-Ads.txt tied to real app store IDs (e.g. `com.example.app`) rather than just domain names
-- **Competitor researchers** tracking SDK adoption and growth trends
+- **Competitor researchers** tracking SDK adoption, quarterly app churn, and growth trends
 - **Privacy advocates** identifying hidden trackers and ad-tech domains in popular apps
 
 

backend/api_app/controllers/public/v1/docs.py

@@ -218,9 +218,10 @@
             "description": (
                 "Endpoint: `GET /api/v1/companies/{company_domain}/app-changes`\n\n"
                 "Access: Paid tiers only.\n\n"
-                "Returns ordered Android and iOS app store IDs for apps added to or "
-                "lost from a company in a specific year/quarter slice, filtered by "
-                "status and a single tag source."
+                "Returns ordered Android and iOS app store IDs for a known company's "
+                "quarterly churn and adoption slice. Use `status=lost` to review apps "
+                "that removed the company in that year/quarter window, or `status=added` "
+                "to review apps that newly added it, filtered by a single tag source."
             ),
         }
     },

backend/tests/test_v1_api.py

@@ -1637,9 +1637,10 @@ def test_openapi_json_only_lists_public_v1_paths(self):
             company_app_changes_operation["description"]
             == "Endpoint: `GET /api/v1/companies/{company_domain}/app-changes`\n\n"
             "Access: Paid tiers only.\n\n"
-            "Returns ordered Android and iOS app store IDs for apps added to or "
-            "lost from a company in a specific year/quarter slice, filtered by "
-            "status and a single tag source."
+            "Returns ordered Android and iOS app store IDs for a known company's "
+            "quarterly churn and adoption slice. Use `status=lost` to review apps "
+            "that removed the company in that year/quarter window, or `status=added` "
+            "to review apps that newly added it, filtered by a single tag source."
         )
         company_app_changes_examples = company_app_changes_operation["responses"][
             "200"

frontend/src/content/blog/2026-company-app-changes-api-churn.mdx

@@ -0,0 +1,64 @@
+---
+title: "AppGoblin's company changes API tracks B2B churn"
+description: "AppGoblin's API lets you track when apps join or leave mobile app B2B companies"
+pubDate: "May 31 2026"
+heroImage: "/blog-images/appgoblin_app_changes_churn_api.png"
+---
+
+# Tracking Vendor Churn and Adoption via API
+
+While many users view the AppGoblin company dataset as a static snapshot, the paid `app-changes` endpoint functions as a highly effective churn-tracking engine for known vendors.
+
+By querying a specific company domain and applying a status filter, you can isolate programmatic shifts in the mobile ecosystem:
+
+*   `GET /api/v1/companies/{company_domain}/app-changes`
+
+### The Core Filters
+*   **`status=lost`**: Reviews the exact apps that *removed* that company's technology during the selected timeframe.
+*   **`status=added`**: Reviews the exact apps that *newly integrated* that company's technology during the selected timeframe.
+
+---
+
+## Why This Matters
+
+Tracking quarterly ecosystem deltas unlocks powerful programmatic workflows for several core B2B teams:
+
+*   **Ad Networks & Mediation Platforms:** Identify apps that recently dropped a direct competitor, instantly generating high-intent lead lists for outbound sales teams.
+*   **Competitor Research & Strategy:** Track the churn and adoption velocity of specific market alternatives quarter-over-quarter.
+*   **Compliance, Privacy, & Security:** Programmatically verify that sunsetted SDKs or deprecated third-party integration partners have been completely removed across a fleet of apps.
+
+> **One Important Boundary:** This endpoint provides a quarterly delta for a *known single domain*. It does not explicitly guarantee or prove that App X removed Vendor A and added Vendor B in a single combined response. However, if your team already targets specific vendors, it provides the exact list of additions and removals you need.
+
+---
+
+## Practical Examples
+
+The endpoint allows you to inspect changes across different relationship layers by modifying the `tag_source` parameter:
+*   `sdk`: For native mobile SDK footprint changes.
+*   `api_call`: For direct server-to-server or app-to-server API integrations.
+*   `app_ads_direct`: For authorized ad seller verification changes via `app-ads.txt`.
+
+### 1. Extracting Competitor Churn (`status=lost`)
+To find apps that dropped a specific vendor (e.g., AppLovin) during a given quarter, isolate the lost SDK signatures:
+
+```bash
+curl -H "X-API-Key: <your-api-token>" \
+  "https://appgoblin.info/api/v1/companies/applovin.com/app-changes?status=lost&tag_source=sdk&year=2026&quarter=1"
+```
+
+### 2. Identifying Market Adoption (`status=added`)
+
+To see which apps are actively onboarding a specific vendor (e.g., ironSource), swap the query to target newly added footprints:
+
+```bash
+curl -H "H-API-Key: <your-api-token>" \
+  "https://appgoblin.info/api/v1/companies/ironsrc.com/app-changes?status=added&tag_source=sdk&year=2026&quarter=1"
+```
+
+## Getting Started
+
+This capability is fully live in the production API environment today. To explore the parameters or upgrade your access tier, visit the resources below:
+
+- Explore the interactive payloads in the AppGoblin API Docs.
+
+- Unlock access to premium company endpoints on the AppGoblin Pricing Page.

frontend/src/content/blog/AppGoblin-API-access-for-metrics-companies-more.mdx

@@ -2,7 +2,7 @@
 title: "AppGoblin Public API now has free and paid access tiers"
 description: "You can now generate AppGoblin API keys on any account, use free app endpoints immediately, and unlock company endpoints plus higher quotas on paid plans."
 pubDate: "May 24 2026"
-heroImage: "/blog-images/blog-placeholder-about.jpg"
+heroImage: "/blog-images/2026_appgoblin_aso_api_release.png"
 ---
 
 

frontend/src/routes/api-docs/+page.svelte

@@ -32,6 +32,23 @@
 <div class="space-y-4 py-4 md:py-6">
 	<div class="px-4 md:px-6">
 		<h1 class="text-2xl font-bold md:text-3xl">API Documentation</h1>
+		<div class="mt-3 max-w-4xl space-y-3 text-sm md:text-base">
+			<p>
+				The AppGoblin public API includes paid company churn tracking through
+				<code>GET /api/v1/companies/{'{'}company_domain{'}'}/app-changes</code>. Query a known
+				company by quarter, then use <code>status=lost</code> to review apps that removed it or
+				<code>status=added</code> to review apps that newly adopted it.
+			</p>
+			<p>
+				This is useful for ad-network prospecting, competitor monitoring, and compliance review. For
+				example, sales teams can pull apps that recently lost a monetization or analytics vendor,
+				while compliance teams can review recent SDK removals for a specific provider.
+			</p>
+			<p class="opacity-80">
+				The current endpoint is scoped to quarterly company deltas for a known domain. It does not
+				directly correlate one vendor's removal with another vendor's addition in the same response.
+			</p>
+		</div>
 	</div>
 
 	<iframe

frontend/src/routes/companies/[domain]/apps-added/+page.svelte

@@ -21,8 +21,8 @@
 <section class="mb-4 space-y-2">
 	<h2 class="text-xl font-semibold">Recently Added Apps</h2>
 	<p class="text-sm mb-3">
-		This view tracks apps that recently added this company through SDK, API-call, or app-ads.txt
-		direct signals across the latest available quarter and the quarter before it.
+		This view tracks the quarterly adoption side of this company's churn data through SDK, API-call,
+		or app-ads.txt direct signals across the latest available quarter and the quarter before it.
 	</p>
 </section>
 

frontend/src/routes/companies/[domain]/apps-lost/+page.svelte

@@ -21,8 +21,9 @@
 <section class="mb-4 space-y-2">
 	<h2 class="text-xl font-semibold">Recently Lost Apps</h2>
 	<p class="text-sm mb-3">
-		This view tracks apps that recently removed this company through SDK, API-call, or app-ads.txt
-		direct signals across the latest available quarter and the quarter before it.
+		This view tracks the quarterly churn side of this company's app-change data through SDK,
+		API-call, or app-ads.txt direct signals across the latest available quarter and the quarter
+		before it.
 	</p>
 </section>
 

frontend/src/routes/pricing/+page.svelte

@@ -94,7 +94,7 @@
 		},
 		{
 			category: 'API Access',
-			name: 'API /companies endpoint',
+			name: 'API /companies + churn endpoints',
 			free: false,
 			sdk: true,
 			appads: true,
@@ -211,6 +211,11 @@
 			through the end of your current billing period. Payments already made are non-refundable.
 		</p>
 
+		<p class="text-sm opacity-80 mt-3 max-w-3xl">
+			Paid API access also unlocks company churn and adoption tracking, including quarterly
+			app-change lists for apps a known vendor recently added or lost.
+		</p>
+
 		<br />
 
 		<!-- Features Table -->