Posts

Add an RSS feed

At most 5 feeds per user, one per URL. The URL must be public.

post/rss-feeds

Request

  • Base URL: https://www.sociahive.com/api/v1
  • URL: https://www.sociahive.com/api/v1/rss-feeds
  • Auth: one of:
    • API key in header X-API-Key
    • OAuth 2 (authorization code, authorization URL /api/oauth/authorize, token URL /api/oauth/token, scopes: posts:write)

Request body

urlstring uri required
platformsstring[]

Platforms to post to. Defaults to the platforms of account_ids; one of the two is required.

mode'draft' | 'ai_draft' | 'ai_schedule'

draft: each new item becomes a draft of its text. ai_draft: AI writes the post, it lands as a draft for review. ai_schedule: AI writes the post and schedules it into the next free posting slot of the feed's accounts, so it publishes without review. When no slot is free in the next 14 days the post stays a draft and you are notified.

image'none' | 'feed' | 'ai'

feed: the item's own image, when it has a public https one. ai: one AI image, counted against the plan's monthly AI image allowance (none once it is used up).

account_idsstring[]
daily_capinteger

Example request

{
  "url": "https://blog.example.com/feed",
  "template": {
    "instructions": "Summarise in two lines and end with a question.",
    "tone": "friendly, no emojis"
  },
  "account_ids": [
    "507f1f77bcf86cd799439011"
  ]
}

Response

RSS feed added

successtrue required

Example response

{
  "data": {
    "_id": "507f1f77bcf86cd799439011",
    "template": {
      "instructions": "Summarise in two lines and end with a question.",
      "tone": "friendly, no emojis"
    },
    "account_ids": [
      "507f1f77bcf86cd799439011"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.