Integrations

List all integrated apps

Retrieves paginated integration apps (Apple, Google, etc.) with analytics data including sync times and credential information.

get/apps

Request

  • Base URL: https://viral.app/api/v1
  • URL: https://viral.app/api/v1/apps
  • Auth: API key in header x-api-key

Query parameters

pagenumber

Page number (1-based index)

Example:1
perPagenumber

Number of items per page (1-100)

Example:10
sortColstring

Sort column

Example:publishedAt
sortDir'asc' | 'desc'

Sort direction

Example:asc
provider'apple' | 'google'

App provider for integrations (apple)

searchstring

Response

OK

pageCountnumber required

Total number of pages

totalRowsnumber required

Total number of rows

Example response

{
  "data": [
    {
      "id": "orgaplapp_R4W8KPM5YTB9",
      "appleCredentialId": "apc_R4W8KPM5YTB9",
      "appleIdentifier": "68912345678900",
      "title": "MyApp - Social Analytics",
      "sku": "com.example.myapp",
      "bundleId": "com.example.myapp",
      "lastSeenAt": "2025-12-20T08:00:00.000Z",
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-12-20T08:00:00.000Z",
      "provider": "apple",
      "credential": {
        "id": "apc_R4W8KPM5YTB9",
        "vendorNumber": "87654321"
      },
      "analyticsLatestLoadAt": "2025-12-20T06:00:00Z",
      "nextSyncAt": "2025-12-21T05:00:00Z"
    },
    {
      "id": "orgaplapp_2B3C4D5E6F7G",
      "appleCredentialId": "apc_R4W8KPM5YTB9",
      "appleIdentifier": "9876543210",
      "title": "MyApp Pro - Premium Analytics",
      "sku": "com.example.myapp.pro",
      "bundleId": "com.example.myapp.pro",
      "lastSeenAt": "2025-12-19T08:00:00.000Z",
      "createdAt": "2025-03-10T14:30:00.000Z",
      "updatedAt": "2025-12-19T08:00:00.000Z",
      "provider": "apple",
      "credential": {
        "id": "apc_R4W8KPM5YTB9",
        "vendorNumber": "87654321"
      },
      "analyticsLatestLoadAt": null,
      "nextSyncAt": "2025-12-21T05:00:00Z"
    }
  ],
  "pageCount": 3,
  "totalRows": 12
}

Changes

No recorded changes to this operation across all 1 revision of this API.