Feeds
Social media feed management operations
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
List of feeds (public + user's private feeds)
Internal server error
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"
}
]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
Name of the feed
Tech News Twitter FeedType of feed (1 for X/Twitter, 2 for Reddit, 3 for YouTube channel)
1Internal identifier - Twitter username for X, subreddit name for Reddit (without r/ prefix). For YouTube channels this is populated automatically.
elonmusk(YouTube only) Channel handle, URL, or ID. Either channel or url may be provided.
https://youtube.com/@AutoContentAPI(YouTube only) Channel URL alternative field.
https://youtube.com/@AutoContentAPIFeed created successfully
Bad request - Missing required fields, feed limit reached, or other validation errors
Unauthorized - valid API token required
Rate limit exceeded - too many requests
Internal server error during feed creation
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"
}Retrieves a specific feed by its ID. Public feeds are accessible without authentication. Private feeds require appropriate token validation.
Feed ID
1Feed details
Bad request - Invalid feed ID
Feed not found
Internal server error
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"
}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
ID of the feed to delete
1Feed deleted successfully
Bad request - Missing or invalid feed ID
Unauthorized - valid API token required
Feed not found or cannot be deleted
Internal server error during feed deletion
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"
}Returns active feed automations associated with the authenticated user. Use includeRemoved=true to include archived subscriptions.
Include subscriptions that have been removed when set to true.
Array of feed subscriptions
Unauthorized - valid API token required
Internal server error while fetching 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": "2025-12-07T13:58:28.187Z",
"removedOn": "2025-12-07T13:58:28.187Z",
"lastProcessedItemId": "text",
"lastProcessedOn": "2025-12-07T13:58:28.187Z",
"request": {}
}
]Links a feed to a schedule template (ClientRequest) so that new feed items trigger automated content generation.
Identifier of the feed to subscribe to.
42Schedule template (ClientRequest) to clone when new items arrive.
123e4567-e89b-12d3-a456-426614174000Optional feed item identifier to mark as already processed.
Subscription created successfully
Validation error
Feed or template not found
Subscription already exists for this feed/template pair
Internal server error during creation
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": "2025-12-07T13:58:28.187Z",
"removedOn": "2025-12-07T13:58:28.187Z",
"lastProcessedItemId": "text",
"lastProcessedOn": "2025-12-07T13:58:28.187Z",
"request": {}
}Soft-deletes a feed subscription by setting its removedOn timestamp.
Identifier of the subscription to remove.
Subscription removed
No content
Missing or invalid subscription identifier
Subscription not found or already removed
Internal server error during removal
DELETE /feeds/subscriptions/{subscriptionId} HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Last updated