# Live Social Media Reddit Tasks

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/business_data/social_media/reddit/live`

**Tags:** DataForSEO

Intended to return Reddit sharing counts for `targets`. 🔴 **Currently unavailable upstream**: it answers `status_code` 50304, `This function temporarily unavailable. Please contact support`, with no `tasks` array at all - the failure is at the top level of the envelope, not inside a task. Wrapped in DataForSEO's envelope: data in `tasks[0].result`, outcome in `tasks[0].status_code` - a rejected request still returns HTTP 200. The Pinterest sibling `post_dataforseo_business_social_media_pinterest_live` works and costs almost nothing; for Reddit content itself, the reddit server reads the platform directly.

### Pricing reference

- Metering: Reported response cost.
- Reference request estimate: USD 0.2428.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.

Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "targets": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "*target URLs* **required field** target page should be specified with its absolute URL (including http:// or https://) example: `https://dataforseo.com/` **Note:** you can specify 10 targets maximum. You will be charged per earch URL you specify in this array"
      },
      "tag": {
        "type": "string",
        "description": "*user-defined task identifier* optional field *the character limit is 255* you can use this parameter to identify the task and match it with the result you will find the specified `tag` value in the `data` object of the response"
      }
    },
    "required": [
      "targets"
    ]
  }
}
```

## Responses

### 200 — Successful response

Headers:
- `X-Request-Id` (string) — Request identifier to include when contacting Felo support.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "*the current version of the API*"
    },
    "version.status_code": {
      "type": "integer",
      "description": "*general status code* you can find the full list of the response codes [here](https://docs.dataforseo.com/v3/appendix/errors.md) **Note:** we strongly recommend designing a necessary system for handling related exceptional or error conditions"
    },
    "version.status_message": {
      "type": "string",
      "description": "*general informational message* you can find the full list of general informational messages [here](https://docs.dataforseo.com/v3/appendix/errors.md)"
    },
    "version.time": {
      "type": "string",
      "description": "*execution time, seconds*"
    },
    "version.cost": {
      "type": "number",
      "description": "*total tasks cost, USD*"
    },
    "version.tasks_count": {
      "type": "integer",
      "description": "*the number of tasks in the **`tasks`**array*"
    },
    "version.tasks_error": {
      "type": "integer",
      "description": "*the number of tasks in the **`tasks`** array returned with an error*"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "*array of tasks*"
    },
    "tasks.id": {
      "type": "string",
      "description": "*unique task identifier in our system* in the [Universally unique identifier (UUID)](https://en.wikipedia.org/wiki/Universally_unique_identifier) format"
    },
    "tasks.status_code": {
      "type": "integer",
      "description": "*status code of the task* generated by DataForSEO; can be within the following range: 10000-60000"
    },
    "tasks.status_message": {
      "type": "string",
      "description": "*informational message of the task*"
    },
    "tasks.time": {
      "type": "string",
      "description": "*execution time, seconds*"
    },
    "tasks.cost": {
      "type": "number",
      "description": "*cost of the task, USD*"
    },
    "tasks.result_count": {
      "type": "integer",
      "description": "*number of elements in the `result` array*"
    },
    "tasks.path": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "*URL path*"
    },
    "tasks.data": {
      "type": "object",
      "description": "*contains the same parameters that you specified in the POST request*"
    },
    "result": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "*array of results*"
    },
    "result.type": {
      "type": "string",
      "description": "*type of element = **‘social\\_media\\_reddit\\_item’***"
    },
    "result.page_url": {
      "type": "string",
      "description": "*URL of the page the data is provided for* corresponding URL you specified in the `targets` array when setting a task"
    },
    "result.reddit reviews": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "*reddit reviews for the page\\_url*"
    },
    "result.subreddit": {
      "type": "string",
      "description": "*the name of the subreddit*"
    },
    "result.author_name": {
      "type": "string",
      "description": "*nickname of the author* nicknname of the user who published the post in the subreddit and shared the URL"
    },
    "result.title": {
      "type": "string",
      "description": "*title of the subreddit post*"
    },
    "result.permalink": {
      "type": "string",
      "description": "*URL to the subreddit post*"
    },
    "result.subreddit_members": {
      "type": "integer",
      "description": "*number of subreddit members*"
    }
  }
}
```

### 400 — The request could not be processed. Check the request parameters.

### 401 — A valid Felo API key is required.

### 402 — The request cannot proceed because a billing requirement is not met.

### 403 — The account is not permitted to perform this operation.

### 429 — A request or spending limit has been reached.

### 502 — The service could not complete the request.

### 503 — The API or billing service is temporarily unavailable.

### 504 — The service timed out while processing the request.

### default — Error response; upstream passthrough responses may use provider formats

**application/json**

Schema:

```json
{}
```