Khoros Stream API
The Stream Api API from Khoros — 25 operation(s) for stream api.
Operations 25
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}
Retrieve a stream's approved content · Retrieve Stream's Approved Content
#
Ask an LLM
“What content has been approved in one of my Khoros streams?”
“Can I pull every approved post from a stream with full-length tweet text?”
Tell an agent
Get the approved content in stream {streamName} for account {account}.
Pull approved items from {account}/{streamName} using tweet mode {tweet_mode}.
GET
/{account}/{streamName}?limit
Pull a set number of approved stream items · Specify amount of content to pull
#
Ask an LLM
“Can I cap how many approved items a stream returns in one call?”
“How many entities can I ask a stream for at once?”
Tell an agent
Fetch only {limit} approved items from stream {streamName} on account {account}.
Give me the latest {limit} entries in {account}/{streamName}.
GET
/{account}/{streamName}?since_id
Get newest stream items after a given entity · Gather content after specific entity
#
Ask an LLM
“How do I poll a stream for only the newest items approved after one I already have, favoring real-time?”
“Will the since_id filter skip items to keep me close to real time?”
Tell an agent
Get items approved in {account}/{streamName} since entity {since_id}, newest first.
Poll {account}/{streamName} for anything newer than {since_id} in near real time.
GET
/{account}/{streamName}?from_id
Page through stream items after an entity, no gaps · Gather content after included entity
#
Ask an LLM
“Can I fetch everything approved after a specific entity without skipping any items?”
“What is the gap-free way to catch up on a stream from a known entity ID?”
Tell an agent
Catch up on {account}/{streamName} starting from entity {from_id} without skipping any.
Walk forward through every approval in {account}/{streamName} after {from_id}.
GET
/{account}/{streamName}?start_id
Get stream items approved before an entity · Gather content before included entity
#
Ask an LLM
“How do I page backwards through older approved items in a stream?”
“Can I get only the entities approved before a given entity ID?”
Tell an agent
List items in {account}/{streamName} approved before entity {start_id}.
Load the older page of {account}/{streamName} preceding {start_id}.
Ask an LLM
“Can a stream response be wrapped in a JavaScript callback for JSONP?”
“Is there JSONP support for embedding stream content in a web page?”
Tell an agent
Return stream {streamName} for account {account} as JSONP with a callback function.
Wrap the {account}/{streamName} feed in a JavaScript callback so my page can embed it.
Ask an LLM
“Can stream items include geohinting location data?”
“How do I turn on geo hints when pulling approved stream content?”
Tell an agent
Pull {account}/{streamName} with geo hint set to {geo_hint}.
Add location geohints to the items from stream {streamName} on {account}.
GET
/{account}/{streamName}?page_links
Get stream items with product page links · Enable product hinting for each entity
#
Ask an LLM
“Can each stream entity come back with product hinting links attached?”
“How do I enable page links for products mentioned in stream items?”
Tell an agent
Fetch {account}/{streamName} with product page links enabled ({page_links}).
Attach product hints to every entity in stream {streamName} of account {account}.
GET
/{account}/{streamName}?replies
Include replied-to posts in stream items · Enable replies to entities
#
Ask an LLM
“Can I see the original post that each stream item was replying to?”
“Which option fills the in_reply_to property on stream entities?”
Tell an agent
Get {account}/{streamName} including the posts each item replied to (replies={replies}).
Show the parent post alongside each reply in {account}/{streamName}.
GET
/{account}/{streamName}?network
Filter stream items by social network · Specify Social Network to gather entities
#
Ask an LLM
“Can I limit a stream to items from just one social network?”
“How do I get only Instagram or only Twitter content out of a mixed stream?”
Tell an agent
Get approved items from network {network} in stream {streamName} for account {account}.
Show only {network} posts from {account}/{streamName}.
GET
/{account}/{streamName}?include_entities
Include entity objects on tweets (XML) · Included entity object on tweets
#
Ask an LLM
“Can tweets in an XML stream response carry their links and media entities?”
“What does include_entities add to tweets on the XML endpoint?”
Tell an agent
Return XML for {account}/{streamName} with tweet entities included ({include_entities}).
Include the links and media objects on each tweet in the {account}/{streamName} XML feed.
GET
/{account}/{streamName}?reverse
Get stream items in chronological order · Reverse order of status entities
#
Ask an LLM
“Can I get the oldest approved items on top instead of the newest?”
“Is the default stream order reverse chronological by approval time?”
Tell an agent
Show {account}/{streamName} in oldest-first approval order (reverse={reverse}).
Flip the order of stream {streamName} on {account} so earliest approvals come first.
GET
/{account}/{streamName}?strip_links
Strip trailing URLs from stream item text · Remove trailing links
#
Ask an LLM
“Can I remove the trailing links from the text of stream posts?”
“Is there a way to get cleaner post text without URLs at the end?”
Tell an agent
Get {account}/{streamName} with trailing links stripped from text ({strip_links}).
Clean the end-of-text URLs off posts in stream {streamName} for {account}.
GET
/{account}/{streamName}?keywords
Filter stream items by keyword · Gather specific entities containing keywords
#
Ask an LLM
“How do I get only the stream items that mention certain keywords?”
“Can a stream be filtered down to posts containing a word or phrase?”
Tell an agent
Find items in {account}/{streamName} that contain {keywords}.
Show posts mentioning {keywords} in stream {streamName} on account {account}.
GET
/{account}/{streamName}?from
Get stream items by one author · Return entities from specific user
#
Ask an LLM
“Can I see only the posts one author contributed to a stream?”
“Does the author filter need to be lowercase?”
Tell an agent
Show items in {account}/{streamName} written by author {author}.
Filter stream {streamName} on {account} to posts from {author} only.
GET
/{account}/{streamName}?timeframe[start]
Get stream items created after a time · Return entities after a specific time
#
Ask an LLM
“How do I get stream items created after a certain date?”
“Does the start of the timeframe filter take seconds or milliseconds?”
Tell an agent
Get items in {account}/{streamName} created after unix time {start}.
Show posts in stream {streamName} for {account} from {start} onward.
GET
/{account}/{streamName}?timeframe[finish]
Get stream items created before a time · Return entities before a specific time
#
Ask an LLM
“Can I limit a stream to items created before a cutoff time?”
“What time format does the timeframe finish filter expect?”
Tell an agent
Get items in {account}/{streamName} created before unix time {finish}.
Show stream {streamName} posts on {account} up until {finish}.
Ask an LLM
“What are the entity counts and activity rates across my account's streams?”
“Where can I see summary meta-information for all streams on an account?”
Tell an agent
Get the stream meta summary for account {account}.
Show entity counts and activity rates for every stream under {account}.
GET
/{account}.json?streams
Get meta info for selected streams of an account · Get meta info of account's streams
#
Ask an LLM
“Can I get account meta-information for just a few named streams?”
“How do I narrow account-level stream stats to a comma-separated list of streams?”
Tell an agent
Get account {account} meta info for streams {streams}.
Summarize activity on {streams} only, within account {account}.
GET
/{account}.json?num_minutes
Get minutes of activity for an account · Get minutes of activity from account
#
Ask an LLM
“How many minutes of activity can I pull in an account's meta data?”
“Can I choose how many minutes of activity an account's stream meta returns?”
Tell an agent
Show {num_minutes} minutes of activity for account {account}.
Give me the per-minute activity history across account {account}.
GET
/{account}.json?num_trends
Get trending topics per bucket for an account · Get trends in response per account
#
Ask an LLM
“What are the top trends across my account's streams?”
“Can I set how many trends come back in each bucket?”
Tell an agent
Return {num_trends} trends per bucket for account {account}.
What is trending in account {account} right now? List the trends.
Ask an LLM
“Can I hide specific trends from my account's trend buckets?”
“Will excluding trends still try to fill the requested trend count?”
Tell an agent
Get account {account} trends but leave out {disregard}.
Drop the trend {disregard} from the trend buckets for {account}.
GET
/{account}.json?start
Get account activity data from a start time · Get activity data from specific time
#
Ask an LLM
“How do I get an account's activity data starting at a particular moment?”
“Can account activity meta begin at a unix timestamp I choose?”
Tell an agent
Get activity data for account {account} starting at unix time {start}.
Begin the activity timeline for {account} at {start}.
GET
/{account}.json?finish
Get account activity data up to an end time · Get activity data ending at specific time
#
Ask an LLM
“Can I end an account's activity data at a specific point in time?”
“Is there an end-time option for account-level activity meta?”
Tell an agent
Get activity data for account {account} ending at a set time.
Cut off the activity timeline for {account} at the end time I give.
GET
/{account}.json?streams_with_topics
List account streams with or without topics · Get streams with/without topics
#
Ask an LLM
“Which of my account's streams have topics configured?”
“Can I find streams that are missing topic configuration?”
Tell an agent
List streams on account {account} filtered by topic configuration {streams_with_topics}.
Show which streams in {account} still have no topics set up.
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