# Live Social Media Pinterest Tasks

**API:** Data API

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

**Tags:** DataForSEO

How many times each of `targets` has been pinned on Pinterest. Returns `type`, `page_url` and `pins_count` per URL. Wrapped in DataForSEO's envelope: data in `tasks[0].result`, outcome in `tasks[0].status_code` - a rejected request still returns HTTP 200. Takes a list, so check a whole site's pages in one call. For Pinterest content rather than counts, the pinterest 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\\_pinterest\\_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.pins_count": {
      "type": "integer",
      "description": "*number of pins for the related `page_url`* [pins on Pinterest](https://help.pinterest.com/en/business/article/build-a-pin) correspond to content saves; this field shows the number of content saves made from the related `page_url` using the [Pinterest Save Button](https://developers.pinterest.com/docs/widgets/save/?)"
    }
  }
}
```

### 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
{}
```