Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Feeds

Social media feed management operations

Get all feeds (public + user's private feeds)

get

Retrieves all public feeds (feeds with no token) and user's private feeds if token is provided.

Public Access:

  • Public feeds are available without authentication

  • Returns all feeds where token is null

Authenticated Access:

  • Returns public feeds + user's private feeds

  • Requires valid API token in Authorization header

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
200

List of feeds (public + user's private feeds)

application/json
idintegerOptional

Unique identifier for the feed

Example: 1
namestringOptional

Name of the feed

Example: Tech News Twitter Feed
tokenstringOptional

Client token (null for public feeds)

Example: abc123-def456-ghi789
feedTypeIdintegerOptional

Type of feed (1 for X/Twitter, 2 for Reddit, 3 for YouTube channel, 4 for RSS, 5 for X News topic)

Example: 1
internalIdstringOptional

Internal identifier for the feed source (username for X, subreddit for Reddit, channel source ID for YouTube)

Example: elonmusk
createdOnstring · date-timeOptional

Creation timestamp

Example: 2023-01-01T12:00:00Z
get/feeds
GET /feeds HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "name": "Tech News Twitter Feed",
    "token": "abc123-def456-ghi789",
    "feedTypeId": 1,
    "internalId": "elonmusk",
    "createdOn": "2023-01-01T12:00:00Z"
  }
]

Create a new feed

post

Creates a new feed associated with the authenticated user.

Feed Types:

  • feedTypeId=1: X/Twitter feed (internalId = username)

  • feedTypeId=2: Reddit feed (internalId = subreddit name without r/ prefix)

  • feedTypeId=3: YouTube channel feed (channel handle/URL, resolved to channel source ID automatically)

  • feedTypeId=4: RSS feed (internalId = feed URL)

  • feedTypeId=5: X News feed (internalId = topic/search query, e.g. "ai")

Access Control:

  • Requires valid API token

  • Feed will be private to the creating user

  • PRO subscription required

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
namestringRequired

Name of the feed

Example: Tech News Twitter Feed
feedTypeIdintegerOptional

Type of feed (1 for X/Twitter, 2 for Reddit, 3 for YouTube channel, 4 for RSS, 5 for X News topic)

Example: 1
internalIdstringOptional

Internal identifier - Twitter username for X, subreddit name for Reddit (without r/ prefix), topic/search query for X News (feedTypeId=5), feed URL for RSS. For YouTube channels this is populated automatically.

Example: elonmusk
channelstringOptional

(YouTube only) Channel handle, URL, or ID. Either channel or url may be provided.

Example: https://youtube.com/@AutoContentAPI
urlstringOptional

(YouTube only) Channel URL alternative field.

Example: https://youtube.com/@AutoContentAPI
Responses
201

Feed created successfully

application/json
successbooleanOptionalExample: true
feedIdintegerOptional

ID of the created feed

Example: 1
messagestringOptionalExample: Feed created successfully
post/feeds
POST /feeds HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 164

{
  "name": "Tech News Twitter Feed",
  "feedTypeId": 1,
  "internalId": "elonmusk",
  "channel": "https://youtube.com/@AutoContentAPI",
  "url": "https://youtube.com/@AutoContentAPI"
}
{
  "success": true,
  "feedId": 1,
  "message": "Feed created successfully"
}

Get a specific feed by ID

get

Retrieves a specific feed by its ID. Public feeds are accessible without authentication. Private feeds require appropriate token validation.

Path parameters
idintegerRequired

Feed ID

Example: 1
Responses
200

Feed details

application/json
idintegerOptional

Unique identifier for the feed

Example: 1
namestringOptional

Name of the feed

Example: Tech News Twitter Feed
tokenstringOptional

Client token (null for public feeds)

Example: abc123-def456-ghi789
feedTypeIdintegerOptional

Type of feed (1 for X/Twitter, 2 for Reddit, 3 for YouTube channel, 4 for RSS, 5 for X News topic)

Example: 1
internalIdstringOptional

Internal identifier for the feed source (username for X, subreddit for Reddit, channel source ID for YouTube)

Example: elonmusk
createdOnstring · date-timeOptional

Creation timestamp

Example: 2023-01-01T12:00:00Z
get/feeds/{id}
GET /feeds/{id} HTTP/1.1
Host: api.autocontentapi.com
Accept: */*

{
  "id": 1,
  "name": "Tech News Twitter Feed",
  "token": "abc123-def456-ghi789",
  "feedTypeId": 1,
  "internalId": "elonmusk",
  "createdOn": "2023-01-01T12:00:00Z"
}

Delete a feed

post

Deletes a feed owned by the authenticated user.

Security:

  • Only the feed owner can delete their feeds

  • Requires valid API token matching the feed's token

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
idintegerRequired

ID of the feed to delete

Example: 1
Responses
200

Feed deleted successfully

application/json
successbooleanOptionalExample: true
messagestringOptionalExample: Feed deleted successfully
post/feeds/delete
POST /feeds/delete HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 8

{
  "id": 1
}
{
  "success": true,
  "message": "Feed deleted successfully"
}

List feed subscriptions for the authenticated token

get

Returns active feed automations associated with the authenticated user. Use includeRemoved=true to include archived subscriptions.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
includeRemovedbooleanOptional

Include subscriptions that have been removed when set to true.

Responses
200

Array of feed subscriptions

application/json
idstring · uuidOptional

Unique identifier for the subscription

Example: 123e4567-e89b-12d3-a456-426614174000
feedIdintegerOptional

Identifier of the subscribed feed

Example: 42
tokenstringOptional

Token that owns the subscription

requestIdstringOptional

ClientRequest template identifier used for automation

createdOnstring · date-timeOptional

When the subscription was created

removedOnstring · date-time · nullableOptional

When the subscription was removed, if applicable

lastProcessedItemIdstring · nullableOptional

Identifier of the last feed item processed for this subscription

lastProcessedOnstring · date-time · nullableOptional

Timestamp of the last processed feed item

requestobject · nullableOptional

Snapshot of the underlying template request

get/feeds/subscriptions
GET /feeds/subscriptions HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "feedId": 42,
    "token": "text",
    "requestId": "text",
    "createdOn": "2026-01-01T00:00:00.000Z",
    "removedOn": "2026-01-01T00:00:00.000Z",
    "lastProcessedItemId": "text",
    "lastProcessedOn": "2026-01-01T00:00:00.000Z",
    "request": {}
  }
]

Create a feed subscription

post

Links a feed to a schedule template (ClientRequest) so that new feed items trigger automated content generation.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
feedIdintegerRequired

Identifier of the feed to subscribe to.

Example: 42
requestIdstringRequired

Schedule template (ClientRequest) to clone when new items arrive.

Example: 123e4567-e89b-12d3-a456-426614174000
lastProcessedItemIdstringOptional

Optional feed item identifier to mark as already processed.

Responses
201

Subscription created successfully

application/json
idstring · uuidOptional

Unique identifier for the subscription

Example: 123e4567-e89b-12d3-a456-426614174000
feedIdintegerOptional

Identifier of the subscribed feed

Example: 42
tokenstringOptional

Token that owns the subscription

requestIdstringOptional

ClientRequest template identifier used for automation

createdOnstring · date-timeOptional

When the subscription was created

removedOnstring · date-time · nullableOptional

When the subscription was removed, if applicable

lastProcessedItemIdstring · nullableOptional

Identifier of the last feed item processed for this subscription

lastProcessedOnstring · date-time · nullableOptional

Timestamp of the last processed feed item

requestobject · nullableOptional

Snapshot of the underlying template request

post/feeds/subscriptions
POST /feeds/subscriptions HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "feedId": 42,
  "requestId": "123e4567-e89b-12d3-a456-426614174000",
  "lastProcessedItemId": "text"
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "feedId": 42,
  "token": "text",
  "requestId": "text",
  "createdOn": "2026-01-01T00:00:00.000Z",
  "removedOn": "2026-01-01T00:00:00.000Z",
  "lastProcessedItemId": "text",
  "lastProcessedOn": "2026-01-01T00:00:00.000Z",
  "request": {}
}

Remove a feed subscription

delete

Soft-deletes a feed subscription by setting its removedOn timestamp.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
subscriptionIdstringRequired

Identifier of the subscription to remove.

Responses
200

Subscription removed

No content
delete/feeds/subscriptions/{subscriptionId}
DELETE /feeds/subscriptions/{subscriptionId} HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content
PreviousProjects
NextDeep Research

Last updated