Provider Coverage

Launch provider coverage and public surface naming for Koil.

Koil exposes provider capabilities through stable provider, surface, resource, content type, variant, and capability names.

Launch Providers

Koil's launch provider set focuses on the providers below. Availability can vary by provider API permissions, account type, and operation readiness.

ProviderCategorySurfaces
InstagramSocial networkmedia; stories; dm
FacebookSocial networkmedia; stories; dm
LinkedInProfessional networkfeed; dm
XSocial networktimeline; dm
YouTubeVideo platformvideos; shorts; live
TikTokShort-form video platformposts; live
Google Business ProfileLocal business profilelocations

Naming Model

  • Provider is the upstream platform, such as instagram, facebook, or youtube.
  • Surface is a broad provider product area customers recognize, such as media, dm, videos, or locations.
  • Resource is a named object collection or read boundary inside a surface, such as items, comments, messages, mentions, reactions, or reviews.
  • Content Type is the fully qualified provider collection used in content APIs, composed as {provider}.{surface}.{resource}, such as instagram.media.items.
  • Variant is a subtype inside a resource, such as feed, reel, story, post, quote, or reply.
  • Capabilities declare which operations and event collection modes a content type supports.

Surface Notes

  • Instagram and Facebook use media for profile media, with resource-local variants such as feed and reel; stories remains separate where the provider exposes a distinct stories edge; dm covers messaging.
  • LinkedIn keeps feed for member/company posts and adds dm for LinkedIn messaging workflows.
  • X uses timeline, not feed, because the provider read model naturally returns a mixed timeline of posts, reposts, quotes, and replies.
  • YouTube splits videos, shorts, and live because uploads, Shorts, and livestreams have different media and lifecycle expectations.
  • TikTok uses posts for profile-authored video/photo posts and live for livestream content.
  • Google Business Profile uses locations; reviews, questions/answers, and local posts are resources under that surface.

On this page