Facebook MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Facebook: 43 typed functions through one MCP server. No Facebook API key needed.

Functions
43
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Facebook

An MCP server for Facebook alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/facebook
Every site

One MCP server for Facebook and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 29
  • browseMarketplaceBrowse a city's Marketplace front page (optionally one category) logged out.

    Arguments

    NameTypeRequired
    citystring
    Facebook's own slug, often region-suffixed: "nyc", "montreal", "trois-rivieres-qc", "kingston-ca".
    Yes
    categorystringNo

    Returns FacebookMarketplaceListing[]

    interface FacebookMarketplaceListing {
      id: string;
      title: string;
      price?: string;
      url?: string;
      location?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/browseMarketplace

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.browseMarketplace({ city: "nyc" });
  • getBusinessDetailsRead a local business Page's contact-card intro, logged out.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns FacebookBusinessDetails

    interface FacebookBusinessDetails {
      name?: string;
      url: string;
      category?: string;
      phone?: string;
      email?: string;
      website?: string;
      address?: string;
      hours?: string;
      services?: string;  // the site's own labels, read the values off a result, never guess one from prose
      priceRange?: string;
      rating?: { recommendPercent?: number; reviewCount?: number };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getBusinessDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getBusinessDetails({ handle: "katzsdeli" });
  • getConversationRead messages in a private conversation thread with another user or group.

    Arguments

    NameTypeRequired
    conversationIdstringYes

    Returns FacebookMessage[]

    interface FacebookMessage {
      id: string;
      senderName: string;
      text: string;
      timestamp?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getConversation({ conversationId: "t.123456789" });
  • getEventDetailsRead a public Event's details.

    Arguments

    NameTypeRequired
    eventIdstringYes

    Returns FacebookEventDetails

    interface FacebookEventDetails {
      id: string;
      name: string;
      url: string;
      startTime?: string;
      location?: string;
      description?: string;
      responderCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getEventDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getEventDetails({ eventId: "298448234317243" });
  • getGroupInfoRead a Group's details, name, description, member count, profile photo.

    Arguments

    NameTypeRequired
    groupIdstringYes

    Returns FacebookGroupInfo

    interface FacebookGroupInfo {
      id: string;
      name: string;
      url: string;
      description?: string;
      memberCount?: number;
      profilePhotoUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getGroupInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getGroupInfo({ groupId: "reactjs" });
  • getGroupPostsList posts in a Group, newest first.

    Arguments

    NameTypeRequired
    groupIdstringYes

    Returns FacebookGroupPost[]

    interface FacebookGroupPost {
      id: string;
      text?: string;
      timestamp?: string;
      likeCount?: number;
      commentCount?: number;
      url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getGroupPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getGroupPosts({ groupId: "reactjs" });
  • getMarketplaceListingDetailsRead a public Marketplace listing's details.

    Arguments

    NameTypeRequired
    listingIdstringYes

    Returns FacebookMarketplaceListingDetails

    interface FacebookMarketplaceListingDetails {
      id: string;
      title: string;
      price?: string;
      description?: string;
      location?: string;
      sellerName?: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getMarketplaceListingDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getMarketplaceListingDetails({ listingId: "994916413658805" });
  • getMarketplaceListingsSearch Facebook Marketplace listings by keyword.

    Arguments

    NameTypeRequired
    querystringYes
    citystring
    A Marketplace city slug, same as browseMarketplace's.
    No

    Returns FacebookMarketplaceListing[]

    interface FacebookMarketplaceListing {
      id: string;
      title: string;
      price?: string;
      url?: string;
      location?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getMarketplaceListings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getMarketplaceListings({ query: "bicycle" });
  • getPageInfoRead a Page's details, name, about section, follower count, category, profile and cover photos, logged out.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns FacebookPageInfo

    interface FacebookPageInfo {
      id: string;
      name: string;
      url: string;
      category?: string;
      about?: string;
      likeCount?: number;
      profilePhotoUrl?: string;
      coverPhotoUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getPageInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getPageInfo({ handle: "nike" });
  • getPagePostsList a Page's newest public posts, logged out.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns FacebookPagePost[]

    interface FacebookPagePost {
      id: string;
      text?: string;
      timestamp?: string;
      likeCount?: number;
      commentCount?: number;
      url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getPagePosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getPagePosts({ handle: "nike" });
  • getPageReviewsRead the reviews people left on a business Page, logged out.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns FacebookPageReview[]

    interface FacebookPageReview {
      id: string;  // the review story's post id
      author: string;
      recommends: boolean;
      text?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getPageReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getPageReviews({ handle: "katzsdeli" });
  • getPersonProfileRead a person's public profile.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns FacebookProfile

    interface FacebookProfile {
      id: string;
      name: string;
      url: string;
      profilePhotoUrl?: string;
      bio?: string;
      friendCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getPersonProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getPersonProfile({ handle: "zuck" });
  • getPhotoAlbumRead a photo album's details.

    Arguments

    NameTypeRequired
    albumIdstringYes

    Returns FacebookPhotoAlbum

    interface FacebookPhoto {
      id: string;
      url?: string;
      caption?: string;
      timestamp?: string;
    }
    
    interface FacebookPhotoAlbum {
      id: string;
      title?: string;
      photoCount?: number;
      createdAt?: string;
      url: string;
      photos: FacebookPhoto[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getPhotoAlbum

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getPhotoAlbum({ albumId: "a.10150123456789" });
  • getPostRead one public post from its link logged out.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns FacebookPost

    interface FacebookPost {
      id: string;
      url: string;
      author?: string;
      text?: string;
      reactionCount?: number;
      shareCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getPost({ url: "<url>" });
  • getPostCommentsRead the top comments under one public post from its link logged out.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns FacebookPostComment[]

    interface FacebookPostComment {
      id: string;
      author?: string;
      text: string;
      timestamp?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getPostComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getPostComments({ url: "<url>" });
  • getPrivacySettingsRead the caller's privacy settings as rendered on Facebook's own Privacy settings page.

    Arguments

    None.

    Returns FacebookPrivacySetting[]

    interface FacebookPrivacySetting {
      id: string;
      label: string;
      value: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getPrivacySettings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getPrivacySettings({});
  • getVideoRead a public video's details.

    Arguments

    NameTypeRequired
    videoIdstringYes

    Returns FacebookVideo

    interface FacebookVideo {
      id: string;
      title?: string;
      description?: string;
      viewCount?: number;
      commentCount?: number;
      timestamp?: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/getVideo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.getVideo({ videoId: "2166091230582141" });
  • listConversationsList the caller's private message threads and people they can message.

    Arguments

    None.

    Returns FacebookConversation[]

    interface FacebookConversation {
      id: string;
      participantName: string;
      lastMessagePreview?: string;
      unread: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/listConversations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.listConversations({});
  • listEventsList upcoming events the caller is invited to or interested in.

    Arguments

    None.

    Returns FacebookEventSummary[]

    interface FacebookEventSummary {
      id: string;
      name: string;
      url: string;
      startTime?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/listEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.listEvents({});
  • listFriendsList the caller's friends or a person's visible friend list.

    Arguments

    None.

    Returns FacebookFriend[]

    interface FacebookFriend {
      id: string;
      name: string;
      url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/listFriends

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.listFriends({});
  • listNotificationsList the caller's recent notifications.

    Arguments

    None.

    Returns FacebookNotification[]

    interface FacebookNotification {
      id: string;
      text?: string;
      timestamp?: string;
      unread: boolean;
      url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/listNotifications

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.listNotifications({});
  • listPageAdsOne advertiser's Meta ads, logged out.

    Arguments

    NameTypeRequired
    pageIdstring
    OR pageUrl.
    No
    pageUrlstringNo
    countrystring
    Default "US"; "ALL" for every country.
    No
    status"active" | "inactive" | "all"
    Which ads to list; both counts come back regardless.
    No
    mediaType"all" | "image" | "video" | "meme" | "none"No
    limitnumber
    1-200, default 30.
    No
    cursorstringNo

    Returns FacebookPageAds

    interface FacebookAd {
      adArchiveId: string;
      adUrl: string;  // facebook.com/ads/library/?id=<adArchiveId>
      pageId: string;
      pageName: string;
      pageUrl: string | null;
      startDate: string | null;  // YYYY-MM-DD (Pacific), when it started running
      endDate: string | null;  // YYYY-MM-DD; null while still running
      isActive: boolean;
      body: string | null;
      headline: string | null;
      linkUrl: string | null;
      linkDescription: string | null;
      caption: string | null;  // display domain under the creative
      ctaText: string | null;  // e.g. "Install now", "Sign up"
      displayFormat: string | null;  // Facebook's label: IMAGE, VIDEO, DCO, DPA, CAROUSEL …
      mediaType: "image" | "video" | "multiple" | "text";
      images: { url: string; resizedUrl: string | null }[];
      videos: { hdUrl: string | null; sdUrl: string | null; previewImageUrl: string | null }[];
      cards: { body: string | null; headline: string | null; linkUrl: string | null; ctaText: string | null; imageUrl: string | null; videoHdUrl: string | null; videoSdUrl: string | null; videoPreviewImageUrl: string | null }[];
      platforms: string[];  // "FACEBOOK" | "INSTAGRAM" | "MESSENGER" | "AUDIENCE_NETWORK" | "WHATSAPP" | "THREADS"
      countries: string[];  // empty when Facebook lists none (most commercial ads outside the EU)
      collationId: string | null;  // versions of one creative share it
      collationCount: number | null;
    }
    
    interface FacebookPageAds {
      pageId: string;
      pageName: string | null;
      totalAds: number | null;  // every ad of this Page in the library for the country, active and inactive
      activeAds: number | null;  // running now
      ads: FacebookAd[];
      totalCount: number | null;  // the count for the status listed
      totalCountIsCapped: boolean;
      nextCursor: string | null;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/listPageAds

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.listPageAds({ pageId: "170321063037656" });
  • listPageEventsList a public Page's own events logged out.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns FacebookPageEvent[]

    interface FacebookPageEvent {
      id: string;
      name: string;
      url: string;
      startTime?: string;
      location?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/listPageEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.listPageEvents({ handle: "nike" });
  • listPageReelsList a public Page's latest reels, logged out.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns FacebookReel[]

    interface FacebookReel {
      id: string;
      url: string;  // /reel/<id>, read details with getVideo({ videoId: id })
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/listPageReels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.listPageReels({ handle: "nike" });
  • listPhotosList photos posted by a Page or person, newest first, logged out.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns FacebookPhoto[]

    interface FacebookPhoto {
      id: string;
      url?: string;
      caption?: string;
      timestamp?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/listPhotos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.listPhotos({ handle: "nike" });
  • searchAdLibrarySearch Meta's public Ad Library, logged out.

    Arguments

    NameTypeRequired
    querystring
    Keyword or advertiser name, e.g. "hinge".
    No
    pageIdstring
    A Page's numeric id, e.g. "170321063037656" (the pageId on any ad).
    No
    pageUrlstring
    "https://www.facebook.com/<handle>", or an Ad Library link with view_all_page_id.
    No
    countrystring
    Two-letter code the ads ran in, default "US"; "ALL" for every country.
    No
    status"active" | "inactive" | "all"
    Default "all".
    No
    mediaType"all" | "image" | "video" | "meme" | "none"
    Default "all".
    No
    limitnumber
    1-200, default 30.
    No
    cursorstring
    NextCursor from an earlier call with the same filters.
    No

    Returns FacebookAdLibrarySearch

    interface FacebookAd {
      adArchiveId: string;
      adUrl: string;  // facebook.com/ads/library/?id=<adArchiveId>
      pageId: string;
      pageName: string;
      pageUrl: string | null;
      startDate: string | null;  // YYYY-MM-DD (Pacific), when it started running
      endDate: string | null;  // YYYY-MM-DD; null while still running
      isActive: boolean;
      body: string | null;
      headline: string | null;
      linkUrl: string | null;
      linkDescription: string | null;
      caption: string | null;  // display domain under the creative
      ctaText: string | null;  // e.g. "Install now", "Sign up"
      displayFormat: string | null;  // Facebook's label: IMAGE, VIDEO, DCO, DPA, CAROUSEL …
      mediaType: "image" | "video" | "multiple" | "text";
      images: { url: string; resizedUrl: string | null }[];
      videos: { hdUrl: string | null; sdUrl: string | null; previewImageUrl: string | null }[];
      cards: { body: string | null; headline: string | null; linkUrl: string | null; ctaText: string | null; imageUrl: string | null; videoHdUrl: string | null; videoSdUrl: string | null; videoPreviewImageUrl: string | null }[];
      platforms: string[];  // "FACEBOOK" | "INSTAGRAM" | "MESSENGER" | "AUDIENCE_NETWORK" | "WHATSAPP" | "THREADS"
      countries: string[];  // empty when Facebook lists none (most commercial ads outside the EU)
      collationId: string | null;  // versions of one creative share it
      collationCount: number | null;
    }
    
    interface FacebookAdLibrarySearch {
      ads: FacebookAd[];
      totalCount: number | null;  // Facebook's own "~N results" for these filters
      totalCountIsCapped: boolean;  // true when that is Facebook's 50,000+ ceiling
      nextCursor: string | null;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/searchAdLibrary

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.searchAdLibrary({ query: "hinge", country: "US", status: "all" });
  • searchGroupsSearch for Groups by name or topic.

    Arguments

    NameTypeRequired
    querystringYes

    Returns FacebookGroupSearchResult[]

    interface FacebookGroupSearchResult {
      id: string;
      name: string;
      url?: string;
      memberCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/searchGroups

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.searchGroups({ query: "reactjs" });
  • searchPagesSearch for Pages by name or category.

    Arguments

    NameTypeRequired
    querystringYes

    Returns FacebookPageSearchResult[]

    interface FacebookPageSearchResult {
      id: string;
      name: string;
      url?: string;
      category?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/searchPages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.searchPages({ query: "NASA" });
  • searchPeopleSearch for Facebook users by name.

    Arguments

    NameTypeRequired
    querystringYes

    Returns FacebookPerson[]

    interface FacebookPerson {
      id: string;
      name: string;
      url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/searchPeople

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.searchPeople({ query: "Alice" });
Act 14
  • commentOnPostLeave a comment on a post, by its permalink URL.

    Arguments

    NameTypeRequired
    postUrlstringYes
    textstringYes

    Returns FacebookComment

    interface FacebookComment {
      id: string;
      postUrl: string;
      text: string;
      posted: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/commentOnPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.commentOnPost({ postUrl: "<postUrl>", text: "<text>" });
  • followPageFollow or unfollow a Page by its handle.

    Arguments

    NameTypeRequired
    handlestringYes
    followbooleanNo

    Returns FacebookPageFollow

    interface FacebookPageFollow {
      id: string;
      handle: string;
      following: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/followPage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.followPage({ handle: "<handle>" });
  • joinGroupRequest to join a Group by its id or url slug.

    Arguments

    NameTypeRequired
    groupIdstringYes

    Returns FacebookGroupJoin

    interface FacebookGroupJoin {
      id: string;
      groupId: string;
      joined: boolean;
      pending?: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/joinGroup

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.joinGroup({ groupId: "<groupId>" });
  • likePhotoLike or unlike a photo.

    Arguments

    NameTypeRequired
    photoUrlstringYes
    likebooleanNo

    Returns FacebookPhotoLike

    interface FacebookPhotoLike {
      id: string;
      photoUrl: string;
      liked: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/likePhoto

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.likePhoto({ photoUrl: "<photoUrl>" });
  • postToGroupPost to a Group the caller is a member of.

    Arguments

    NameTypeRequired
    groupIdstringYes
    textstringYes

    Returns FacebookGroupPostResult

    interface FacebookGroupPostResult {
      id: string;
      groupId: string;
      text: string;
      posted: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/postToGroup

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.postToGroup({ groupId: "<groupId>", text: "<text>" });
  • postToPagePost to a Page the caller owns or administrates.

    Arguments

    NameTypeRequired
    handlestringYes
    textstringYes

    Returns FacebookPagePostResult

    interface FacebookPagePostResult {
      id: string;
      handle: string;
      text: string;
      posted: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/postToPage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.postToPage({ handle: "<handle>", text: "<text>" });
  • postToTimelineWrite a text post to the caller's own timeline.

    Arguments

    NameTypeRequired
    textstringYes

    Returns FacebookTimelinePost

    interface FacebookTimelinePost {
      id: string;
      text: string;
      posted: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/postToTimeline

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.postToTimeline({ text: "<text>" });
  • reactToPostReact to a post with like, love, haha, wow, sad or angry, by its permalink URL.

    Arguments

    NameTypeRequired
    postUrlstringYes
    reactionFacebookReactionKindYes

    Returns FacebookReaction

    type FacebookReactionKind = "like" | "love" | "haha" | "wow" | "sad" | "angry";
    
    interface FacebookReaction {
      id: string;
      postUrl: string;
      reaction: FacebookReactionKind;
      reacted: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/reactToPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.reactToPost({ postUrl: "<postUrl>", reaction: "<reaction>" });
  • replyToCommentReply to a comment on a post, by the comment's own permalink URL.

    Arguments

    NameTypeRequired
    commentUrlstringYes
    textstringYes

    Returns FacebookCommentReply

    interface FacebookCommentReply {
      id: string;
      commentUrl: string;
      text: string;
      posted: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/replyToComment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.replyToComment({ commentUrl: "<commentUrl>", text: "<text>" });
  • savePostSave (bookmark) a post for later or add to a saved collection.

    Arguments

    NameTypeRequired
    postUrlstringYes

    Returns FacebookSavedPost

    interface FacebookSavedPost {
      id: string;
      postUrl: string;
      saved: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/savePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.savePost({ postUrl: "<postUrl>" });
  • sendMessageSend a direct message in an existing conversation thread.

    Arguments

    NameTypeRequired
    conversationIdstringYes
    textstringYes

    Returns FacebookSentMessage

    interface FacebookSentMessage {
      id: string;
      conversationId: string;
      text: string;
      sent: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/sendMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.sendMessage({ conversationId: "<conversationId>", text: "<text>" });
  • sharePostShare a post to the caller's own timeline, by its permalink URL.

    Arguments

    NameTypeRequired
    postUrlstringYes

    Returns FacebookSharedPost

    interface FacebookSharedPost {
      id: string;
      postUrl: string;
      shared: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/sharePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.sharePost({ postUrl: "<postUrl>" });
  • updatePrivacySettingsChange the caller's "Who can see your future posts?" audience setting.

    Arguments

    NameTypeRequired
    setting"futurePostsAudience"Yes
    valueFacebookPrivacySettingAudienceYes

    Returns FacebookPrivacySettingUpdate

    interface FacebookPrivacySettingUpdate {
      id: string;
      setting: string;
      value: string;
      updated: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/updatePrivacySettings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.updatePrivacySettings({ setting: "futurePostsAudience", value: "<value>" });
  • updateProfileEdit the caller's own profile bio.

    Arguments

    NameTypeRequired
    biostringYes

    Returns FacebookProfileUpdate

    interface FacebookProfileUpdate {
      id: string;
      bio: string;
      updated: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/facebook/updateProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.facebook.updateProfile({ bio: "<bio>" });

Use it from code