Khoros

Khoros Meta.json API

The Meta.json API from Khoros — 18 operation(s) for meta.json.

GitHub OpenAPI

Operations 18

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 /{account}/{streamName}/meta.json Get summary metadata for a stream · Get entity information #
Ask an LLM
“What summary information can I get about the entities in a social stream?”
“How do I pull the meta.json overview for one of our streams?”
Tell an agent
Get the meta summary for stream {stream} in account {account}.
Show what is derived from the entities in stream {stream} for account {account}.
GET /{account}/{streamName}/meta.json?num_minutes Get a stream's activity by the minute · Get minutes of activity #
Ask an LLM
“Can I see minute-by-minute activity for a stream?”
“How many minutes of activity can the stream meta response cover?”
Tell an agent
Get the last {minutes} minutes of activity for stream {stream} in account {account}.
Show per-minute activity for stream {stream} in account {account}.
GET /{account}/{streamName}/meta.json?num_hours Get a stream's activity by the hour · Get hours of activity #
Ask an LLM
“Can I get hourly activity counts for a stream?”
“What does a stream's activity look like broken into hours?”
Tell an agent
Get the last {hours} hours of activity for stream {stream} in account {account}.
Show hourly activity for stream {stream} in account {account}.
GET /{account}/{streamName}/meta.json?num_days Get a stream's activity by the day · Get days of activity #
Ask an LLM
“Can I see daily activity totals for a stream over several days?”
“What does a stream's activity look like day by day?”
Tell an agent
Get the last {days} days of activity for stream {stream} in account {account}.
Show daily activity for stream {stream} in account {account}.
GET /{account}/{streamName}/meta.json?activity Include activity and count totals in stream meta · Get activity and count props #
Ask an LLM
“How do I make the stream meta response include activity and count properties?”
“Can stream metadata return item counts alongside activity?”
Tell an agent
Get stream {stream} metadata for account {account} with activity and count properties.
Include activity and counts in the meta response for stream {stream} in account {account}.
GET /{account}/{streamName}/meta.json?finish Set where a stream's activity data ends · Get last item of activity #
Ask an LLM
“Can I make stream activity data stop at a specific point in time?”
“How do I cap stream activity at a Unix timestamp?”
Tell an agent
Get activity for stream {stream} in account {account} ending at {finish}.
End the activity data for stream {stream} in account {account} at Unix time {finish}.
GET /{account}/{streamName}/meta.json? networks List the networks a stream covers · Get networks in meta response #
Ask an LLM
“Which social networks does a stream pull content from?”
“Can the stream meta response include its list of networks?”
Tell an agent
List the networks in stream {stream} for account {account}.
Include the networks array in the meta response for stream {stream} in account {account}.
GET /{account}/{streamName}/meta.json?top_periods Get top retweets for specific hourly periods · Get top retweets in specified hours #
Ask an LLM
“Can I get the top retweeted posts for particular hours in a stream?”
“Which tweets were most retweeted during specific hourly periods I choose?”
Tell an agent
Get the top retweets in stream {stream} for account {account} during hourly periods {periods}.
Show the most retweeted posts in stream {stream} of account {account} for periods {periods}.
GET /{account}/{streamName}/meta.json?top_periods_relative Get top retweets for hours counted back from now · Get top retweets hourly from now #
Ask an LLM
“Can I see the top tweets from a few hours ago, counted back from now?”
“What were the most retweeted posts in recent relative hourly periods?”
Tell an agent
Get top retweets in stream {stream} for account {account} from {hours_ago} hours ago.
List the leading tweets in stream {stream} of account {account} counting {hours_ago} hourly periods back from now.
GET /{account}/{streamName}/meta.json?top_count Set how many top tweets to return per period · Get tweets per period #
Ask an LLM
“How many top tweets can I include for each period in stream meta?”
“Can I limit the number of tweets returned per period?”
Tell an agent
Return {count} top tweets per period for stream {stream} in account {account}.
Limit stream {stream} in account {account} to {count} tweets per period.
GET /{account}/{streamName}/meta.json?num_hashtags Get a stream's top hashtags · Get number of hashtags returned #
Ask an LLM
“Which hashtags show up most in a stream?”
“Can I choose how many hashtags the stream meta returns?”
Tell an agent
Get the top {count} hashtags in stream {stream} for account {account}.
List the leading hashtags in stream {stream} of account {account}.
GET /{account}/{streamName}/meta.json?num_contributors Get a stream's top contributors · Get number of contributors #
Ask an LLM
“Who are the most active contributors posting in a stream?”
“Can I choose how many contributor handles are returned?”
Tell an agent
Get the top {count} contributor handles in stream {stream} for account {account}.
List the most active contributors in stream {stream} of account {account}.
GET /{account}/{streamName}/meta.json?num_trends Get a stream's top topics · Get number of topics #
Ask an LLM
“What topics are trending in a stream, and how many topic buckets can I get?”
“Can I choose how many trend buckets the stream meta returns?”
Tell an agent
Get the top {count} topics in stream {stream} for account {account}.
Return {count} trend buckets for stream {stream} of account {account}.
GET /{account}/{streamName}/meta.json?sort Sort a stream's returned topics · Get Specified Sort Order #
Ask an LLM
“Can I control the sort order of topics in the stream meta response?”
“How are stream topics ordered, and can I change that?”
Tell an agent
Sort the topics for stream {stream} in account {account} by {sort}.
Return stream {stream} topics for account {account} in {sort} order.
GET /{account}/{streamName}/meta.json?all_topics Include zero-count topics in stream meta · Get all topics #
Ask an LLM
“Can I see every topic in a stream, even ones with no mentions?”
“How do I include topics whose count is zero?”
Tell an agent
Get all topics for stream {stream} in account {account}, including empty ones.
Include zero-count topics in the meta response for stream {stream} of account {account}.
GET /{account}/{streamName}/meta.json?percent Show topic bucket shares as percentages · Get percentages in buckets #
Ask an LLM
“Can stream topic buckets be returned as percentages of the total?”
“What share of a stream's volume does each topic bucket hold?”
Tell an agent
Get percentage shares per bucket for stream {stream} in account {account}.
Return bucket percentages for the total group of stream {stream} in account {account}.
GET /{account}/{streamName}/meta.json?precision Set decimal places for stream meta percentages · Get specific decimals in percent return #
Ask an LLM
“How many decimal places can the percentages in stream metadata have?”
“Can I round stream meta percentages to fewer decimals?”
Tell an agent
Return stream {stream} percentages for account {account} with {places} decimal places.
Round the meta percentages for stream {stream} in account {account} to {places} decimals.

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-meta-json-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-meta-json-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

khoros-ai-meta-json-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: stream-api Meta.json API
  version: '1.1'
servers:
- url: https://api.massrelevance.com
security:
- sec0: []
tags:
- name: Meta.json
paths:
  /{account}/{streamName}/meta.json:
    get:
      summary: Get entity information
      description: Provides information about and derived from the entities in a stream
      operationId: get-entity-information
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?num_minutes:
    get:
      summary: Get minutes of activity
      description: Retrieve the number of minutes of activity
      operationId: get-minutes-of-activity
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: num_minutes
        in: query
        schema:
          type: integer
          format: int32
          default: 60
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?num_hours:
    get:
      summary: Get hours of activity
      description: Retrieve the number of activity hours
      operationId: get-minutes-of-activity-1
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: num_hours
        in: query
        schema:
          type: integer
          format: int32
          default: 2
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?num_days:
    get:
      summary: Get days of activity
      description: Retrieve the number of activity days
      operationId: get-days-of-activity
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: num_days
        in: query
        schema:
          type: integer
          format: int32
          default: 30
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?activity:
    get:
      summary: Get activity and count props
      description: Include activity and count properties in response
      operationId: get-activity-and-count-props
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: activity
        in: query
        description: '**Format:** binary'
        schema:
          type: boolean
          default: true
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?finish:
    get:
      summary: Get last item of activity
      description: Unix time of the point of which activity data should end
      operationId: get-last-item-of-activity
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: finish
        in: query
        schema:
          type: integer
          format: int32
          default: 1349278694
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json? networks:
    get:
      summary: Get networks in meta response
      description: Include networks property in the response, which is an array of strings
      operationId: get-networks-in-meta-response-1
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: networks
        in: query
        schema:
          type: boolean
          default: true
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?top_periods:
    get:
      summary: Get top retweets in specified hours
      description: Include top tweets from specific hourly periods provided
      operationId: get-networks-in-meta-response
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: top_periods
        in: query
        schema:
          type: string
          default: '2012070412'
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?top_periods_relative:
    get:
      summary: Get top retweets hourly from now
      description: Include top tweets from specific hourly periods ago from now
      operationId: get-top-retweets-hourly-from-now-1
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: top_periods_relative
        in: query
        schema:
          type: string
          default: '1'
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?top_count:
    get:
      summary: Get tweets per period
      description: Number of tweets to include per period
      operationId: get-top-retweets-hourly-from-now
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: top_count
        in: query
        schema:
          type: integer
          format: int32
          default: 5
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?num_hashtags:
    get:
      summary: Get number of hashtags returned
      description: Retrieves the number of hashtags.
      operationId: get-number-of-hashtags-returned-1
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: num_hashtags
        in: query
        schema:
          type: integer
          format: int32
          default: 10
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?num_contributors:
    get:
      summary: Get number of contributors
      description: Number of contributor user handles to return
      operationId: get-number-of-topics
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: num_contributors
        in: query
        schema:
          type: integer
          format: int32
          default: 5
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?num_trends:
    get:
      summary: Get number of topics
      description: Retrieves the number of topics (buckets).
      operationId: get-number-of-hashtags-returned
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: num_trends
        in: query
        schema:
          type: integer
          format: int32
          default: 5
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?sort:
    get:
      summary: Get Specified Sort Order
      description: Determines the sort order for returned topics
      operationId: get-specified-sort-order
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: sort
        in: query
        schema:
          type: string
          default: position asc
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?all_topics:
    get:
      summary: Get all topics
      description: Returns all topics, not just those with count > 0
      operationId: get-all-topics
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: all_topics
        in: query
        schema:
          type: integer
          format: int32
          default: 3
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?percent:
    get:
      summary: Get percentages in buckets
      description: Returns percentages (PCT) in buckets (Total group only, not top)
      operationId: get-percentages-in-buckets
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: percent
        in: query
        schema:
          type: integer
          format: int32
          default: 1
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?precision:
    get:
      summary: Get specific decimals in percent return
      description: Determines the number of decimal places to return in percentages
      operationId: get-specific-decimals-in-percent-return
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: precision
        in: query
        schema:
          type: integer
          format: int32
          default: 1
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
  /{account}/{streamName}/meta.json?disregard:
    get:
      summary: Get excluded trends from values
      description: Exclude trends that match supplied values from buckets while trying to ensure `num_trends` is met
      operationId: get-excluded-trends-from-values
      parameters:
      - name: account
        in: path
        schema:
          type: string
        required: true
      - name: streamName
        in: path
        schema:
          type: string
        required: true
      - name: disregard
        in: query
        schema:
          type: integer
          format: int32
          default: null
      responses:
        '200':
          description: '200'
          content:
            text/plain:
              examples:
                Result:
                  value: Coming Soon
      deprecated: false
      security: []
      tags:
      - Meta.json
components:
  securitySchemes:
    sec0:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://example.com/oauth2/token
          scopes: {}
x-readme:
  headers: []
  explorer-enabled: false
  proxy-enabled: true
x-readme-fauxas: true