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

Responses

200

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

application/json

500

Internal server error

get

HTTPcURLJavaScriptPython

GET /feeds HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
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)

Access Control:

• Requires valid API token

• Feed will be private to the creating user

• PRO subscription required

Authorizations

Body

namestringRequired

Name of the feed

Example: Tech News Twitter Feed

feedTypeIdintegerOptional

Type of feed (1 for X/Twitter, 2 for Reddit)

Example: 1

internalIdstringOptional

Internal identifier - Twitter username for X, subreddit name for Reddit (without r/ prefix)

Example: elonmusk

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

HTTPcURLJavaScriptPython

POST /feeds HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "name": "Tech News Twitter Feed",
  "feedTypeId": 1,
  "internalId": "elonmusk"
}

{
  "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

400

Bad request - Invalid feed ID

application/json

404

Feed not found

application/json

500

Internal server error

get

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

Body

idintegerRequired

ID of the feed to delete

Example: 1

Responses

200

Feed deleted successfully

application/json

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

HTTPcURLJavaScriptPython

POST /feeds/delete HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 8

{
  "id": 1
}

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