Khoros

Khoros Report API

The Report API from Khoros — 1 operation(s) for report.

Documentation GitHub OpenAPI

Operations 1

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /report/reports/{workflowId}/{runId}/status Check an export job's status · Get export job status #

Ask an LLM

“How do I know if a Care export job has finished running?”

“Which status URL should I poll after starting an export?”

Tell an agent

Check status of export workflow {workflowId} run {runId}.

Poll run {runId} of workflow {workflowId} until the export is ready.

Documentation

📖

Documentation

https://developer.khoros.com/khoroscaredevdocs/docs/khoros-care-integration-overview

📖

Documentation

https://developer.khoros.com/khorosmarketingdevdocs/docs/developing-and-integrating-with-khoros-marketing

📖

Documentation

https://developer.khoros.com/khoros-flow/docs/overview-of-khoros-flow-apis

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/khoros-ai/refs/heads/main/openapi/khoros-ai-report-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/khoros-ai:khoros-ai-report-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: analytics-reports Report API
  version: '1.1'
servers:
- url: https://analytics-api.app.lithium.com/api/public
security:
- sec0: []
tags:
- name: Report
paths:
  /report/reports/{workflowId}/{runId}/status:
    get:
      summary: Get export job status
      description: Check the status of an export job. This endpoint is returned in the `statusUrl` field of the response to a generate export requests (e.g., /reports/report/author).
      operationId: reportsreportworkflowidrunidstatus
      parameters:
      - name: workflowId
        in: path
        description: 'The `workflowId` returned in the response to a export generation request (e.g., /reports/report/author).<br>Example: f71ccb0c-afdc-32c6-8bfd-443f8eabae87'
        schema:
          type: string
        required: true
      - name: runId
        in: path
        description: 'The `runId` returned in the response to a export generation request (e.g., /reports/report/author)<br>Example: 23nUak09Gc3t5K65L3GMQ3Y1onNYtvSsfUSuqEO0+pkHA='
        schema:
          type: string
        required: true
      - name: analyticsAccessToken
        in: query
        description: The access token returned in the `statusUrl` field of the response to a export generation request (e.g., /reports/report/author)
        required: true
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Report ready to download:
                  value: "{\n  \"status\": \"PASS\",\n  \"request\": null,\n  \"message\": null,\n  \"result\": {\n    \"jobInfo\": {\n      \"workflowId\": \"f71ccb0c-afdc-32c6-8bfd-443f8eabae87\",\n      \"runId\": \"23nUak09Gc3t5K65L3GMQ3Y1onNYtvSsfUSuqEO0+pkHA=\",\n      \"downloadUrl\": \"https://analytics-api.app.lithium.com/api/public/reports/report/f71ccb0c-afdc-32c6-8bfd-443f8eabae87/23nUak09Gc3t5K65L3GMQ3Y1onNYtvSsfUSuqEO0%2BpkHA%3D/download?analyticsAccessToken=oMqgB5T7BikRH3ISPxlqIw%3D%3D\",\n      \"statusUrl\": \"https://analytics-api.app.lithium.com/api/public/reports/report/f71ccb0c-afdc-32c6-8bfd-443f8eabae87/23nUak09Gc3t5K65L3GMQ3Y1onNYtvSsfUSuqEO0%2BpkHA%3D/status?analyticsAccessToken=oMqgB5T7BikRH3ISPxlqIw%3D%3D\"\n    },\n    \"result\": {\n      \"runnerState\": \"CLOSED\",\n      \"reason\": null,\n      \"detail\": \"COMPLETED\",\n      \"currentCount\": null,\n      \"totalCount\": null,\n      \"lastAcknowledgeTime\": null\n    }\n  }\n}"
                Export still running:
                  value: "{\n  \"status\": \"PASS\",\n  \"request\": null,\n  \"message\": null,\n  \"result\": [\n    {\n      \"jobInfo\": {\n        \"workflowId\": \"57113d95-0745-320b-9269-00de3a9a3128\",\n        \"runId\": \"23g+OxKtvHZugyyn1PN+0y5u7EFFtnRDBbyRjEeXWSRcQ=\",\n        \"downloadUrl\": \"\",\n        \"statusUrl\": \"https://analytics-api.app.lithium.com/api/public/reports/report/57113d95-0745-320b-9269-00de3a9a3128/23g%2BOxKtvHZugyyn1PN%2B0y5u7EFFtnRDBbyRjEeXWSRcQ%3D/status?analyticsAccessToken=53u6j8zjSLAe6e%2F8s80LtA%3D%3D\"\n      },\n      \"result\": {\n        \"runnerState\": \"RUNNING\",\n        \"reason\": null,\n        \"detail\": \"\",\n        \"currentCount\": null,\n        \"totalCount\": null,\n        \"lastAcknowledgeTime\": null\n      }\n    }\n  ]\n}"
                Export finished but failed:
                  value: "{\n  \"status\": \"PASS\",\n  \"request\": null,\n  \"message\": null,\n  \"result\": [\n    {\n      \"jobInfo\": {\n        \"workflowId\": \"57113d95-0745-320b-9269-00de3a9a3128\",\n        \"runId\": \"23g+OxKtvHZugyyn1PN+0y5u7EFFtnRDBbyRjEeXWSRcQ=\",\n        \"downloadUrl\": \"\",\n        \"statusUrl\": \"https://analytics-api.app.lithium.com/api/public/reports/report/57113d95-0745-320b-9269-00de3a9a3128/23g%2BOxKtvHZugyyn1PN%2B0y5u7EFFtnRDBbyRjEeXWSRcQ%3D/status?analyticsAccessToken=53u6j8zjSLAe6e%2F8s80LtA%3D%3D\"\n      },\n      \"result\": {\n        \"runnerState\": \"CLOSED\",\n        \"reason\": null,\n        \"detail\": \"FAILED\",\n        \"currentCount\": null,\n        \"totalCount\": null,\n        \"lastAcknowledgeTime\": null\n      }\n    }\n  ]\n}"
              schema:
                oneOf:
                - title: Report ready to download
                  type: object
                  properties:
                    status:
                      type: string
                      example: PASS
                    request: {}
                    message: {}
                    result:
                      type: object
                      properties:
                        jobInfo:
                          type: object
                          properties:
                            workflowId:
                              type: string
                              example: f71ccb0c-afdc-32c6-8bfd-443f8eabae87
                            runId:
                              type: string
                              example: 23nUak09Gc3t5K65L3GMQ3Y1onNYtvSsfUSuqEO0+pkHA=
                            downloadUrl:
                              type: string
                              example: https://analytics-api.app.lithium.com/api/public/reports/report/f71ccb0c-afdc-32c6-8bfd-443f8eabae87/23nUak09Gc3t5K65L3GMQ3Y1onNYtvSsfUSuqEO0%2BpkHA%3D/download?analyticsAccessToken=oMqgB5T7BikRH3ISPxlqIw%3D%3D
                            statusUrl:
                              type: string
                              example: https://analytics-api.app.lithium.com/api/public/reports/report/f71ccb0c-afdc-32c6-8bfd-443f8eabae87/23nUak09Gc3t5K65L3GMQ3Y1onNYtvSsfUSuqEO0%2BpkHA%3D/status?analyticsAccessToken=oMqgB5T7BikRH3ISPxlqIw%3D%3D
                        result:
                          type: object
                          properties:
                            runnerState:
                              type: string
                              example: CLOSED
                            reason: {}
                            detail:
                              type: string
                              example: COMPLETED
                            currentCount: {}
                            totalCount: {}
                            lastAcknowledgeTime: {}
                - title: Export still running
                  type: object
                  properties:
                    status:
                      type: string
                      example: PASS
                    request: {}
                    message: {}
                    result:
                      type: array
                      items:
                        type: object
                        properties:
                          jobInfo:
                            type: object
                            properties:
                              workflowId:
                                type: string
                                example: 57113d95-0745-320b-9269-00de3a9a3128
                              runId:
                                type: string
                                example: 23g+OxKtvHZugyyn1PN+0y5u7EFFtnRDBbyRjEeXWSRcQ=
                              downloadUrl:
                                type: string
                                example: ''
                              statusUrl:
                                type: string
                                example: https://analytics-api.app.lithium.com/api/public/reports/report/57113d95-0745-320b-9269-00de3a9a3128/23g%2BOxKtvHZugyyn1PN%2B0y5u7EFFtnRDBbyRjEeXWSRcQ%3D/status?analyticsAccessToken=53u6j8zjSLAe6e%2F8s80LtA%3D%3D
                          result:
                            type: object
                            properties:
                              runnerState:
                                type: string
                                example: RUNNING
                              reason: {}
                              detail:
                                type: string
                                example: ''
                              currentCount: {}
                              totalCount: {}
                              lastAcknowledgeTime: {}
                - title: Export finished but failed
                  type: object
                  properties:
                    status:
                      type: string
                      example: PASS
                    request: {}
                    message: {}
                    result:
                      type: array
                      items:
                        type: object
                        properties:
                          jobInfo:
                            type: object
                            properties:
                              workflowId:
                                type: string
                                example: 57113d95-0745-320b-9269-00de3a9a3128
                              runId:
                                type: string
                                example: 23g+OxKtvHZugyyn1PN+0y5u7EFFtnRDBbyRjEeXWSRcQ=
                              downloadUrl:
                                type: string
                                example: ''
                              statusUrl:
                                type: string
                                example: https://analytics-api.app.lithium.com/api/public/reports/report/57113d95-0745-320b-9269-00de3a9a3128/23g%2BOxKtvHZugyyn1PN%2B0y5u7EFFtnRDBbyRjEeXWSRcQ%3D/status?analyticsAccessToken=53u6j8zjSLAe6e%2F8s80LtA%3D%3D
                          result:
                            type: object
                            properties:
                              runnerState:
                                type: string
                                example: CLOSED
                              reason: {}
                              detail:
                                type: string
                                example: FAILED
                              currentCount: {}
                              totalCount: {}
                              lastAcknowledgeTime: {}
      deprecated: false
      security: []
      x-readme:
        code-samples:
        - language: curl
          code: curl -u '[USERNAME]:[PASSWORD]' 'https://analytics-api.app.lithium.com/api/public/reports/report/<workflowId>/<runId>/status?analyticsAccessToken=[ACCESS_TOKEN]'
        samples-languages:
        - curl
      tags:
      - Report
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
x-readme:
  headers: []
  explorer-enabled: false
  proxy-enabled: false
x-readme-fauxas: true