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

bearerAuth

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)

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

500

Internal server error

get

/feeds

HTTPcURLJavaScriptPython

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)

Access Control:

• Requires valid API token

• Feed will be private to the creating user

• PRO subscription required

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

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)

Example: 1

internalIdstringOptional

Internal identifier - Twitter username for X, subreddit name for Reddit (without r/ prefix). 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

400

Bad request - Missing required fields, feed limit reached, or other validation errors

application/json

401

Unauthorized - valid API token required

429

Rate limit exceeded - too many requests

application/json

500

Internal server error during feed creation

post

/feeds

HTTPcURLJavaScriptPython

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)

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

400

Bad request - Invalid feed ID

application/json

404

Feed not found

application/json

500

Internal server error

get

/feeds/{id}

HTTPcURLJavaScriptPython

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

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

idintegerRequired

ID of the feed to delete

Example: 1

Responses

200

Feed deleted successfully

application/json

successbooleanOptionalExample: true

messagestringOptionalExample: Feed deleted successfully

400

Bad request - Missing or invalid feed ID

application/json

401

Unauthorized - valid API token required

404

Feed not found or cannot be deleted

application/json

500

Internal server error during feed deletion

post

/feeds/delete

HTTPcURLJavaScriptPython

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

bearerAuth

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

401

Unauthorized - valid API token required

500

Internal server error while fetching subscriptions

get

/feeds/subscriptions

HTTPcURLJavaScriptPython

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-03-17T18:51:04.775Z",
    "removedOn": "2026-03-17T18:51:04.775Z",
    "lastProcessedItemId": "text",
    "lastProcessedOn": "2026-03-17T18:51:04.775Z",
    "request": {}
  }
]

Create a feed subscription

post

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

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

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

400

Validation error

404

Feed or template not found

409

Subscription already exists for this feed/template pair

500

Internal server error during creation

post

/feeds/subscriptions

HTTPcURLJavaScriptPython

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-03-17T18:51:04.775Z",
  "removedOn": "2026-03-17T18:51:04.775Z",
  "lastProcessedItemId": "text",
  "lastProcessedOn": "2026-03-17T18:51:04.775Z",
  "request": {}
}

Remove a feed subscription

delete

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

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

subscriptionIdstringRequired

Identifier of the subscription to remove.

Responses

200

Subscription removed

No content

400

Missing or invalid subscription identifier

404

Subscription not found or already removed

500

Internal server error during removal

delete

/feeds/subscriptions/{subscriptionId}

HTTPcURLJavaScriptPython

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

No content