Skip to main content
POST
实时社交媒体 Pinterest 任务
Social Media Pinterest API 将为您提供从指定 URL 创建的 Pin 数据。Pinterest 上的 Pin 对应内容保存操作。对于每个指定的页面 URL,您将获得通过页面上放置的 Pinterest 保存按钮 将内容保存到 Pinterest 的次数。

示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
targets
string[]
必填

目标 URL 必填字段 目标页面应使用其绝对 URL(包括 http:// 或 https://)指定,示例:https://dataforseo.com/注意:最多可以指定 10 个目标。您需要为此数组中指定的每个搜索 URL 付费

tag
string

用户定义的任务标识符,可选字段,字符数上限为 255。你可以使用此参数标识任务并将其与结果匹配;你可以在响应的 data 对象中找到指定的 tag

响应

成功响应

version
string

API 的当前版本

version.status_code
integer

常规状态代码 您可以在此处查看完整的响应代码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况

version.status_message
string

一般信息消息 你可以在此处查看一般信息消息的完整列表

version.time
string

执行时间(秒)

version.cost
number

任务总成本(美元)

version.tasks_count
integer

tasks数组中的任务数量

version.tasks_error
integer

返回的 tasks 数组中发生错误的任务数量

tasks
string[]

任务数组

tasks.id
string

我们系统中的唯一任务标识符,采用通用唯一标识符 (UUID) 格式

tasks.status_code
integer

DataForSEO 生成的任务状态码;取值范围为:10000-60000

tasks.status_message
string

任务信息消息

tasks.time
string

执行时间(秒)

tasks.cost
number

任务成本(美元)

tasks.result_count
integer

result 数组中的元素数量

tasks.path
string[]

URL 路径

tasks.data
object

包含与您在 POST 请求中指定的参数相同的参数

result
string[]

结果数组

result.type
string

元素类型 = ‘social_media_pinterest_item’

result.page_url
string

数据所对应页面的 URL,即设置任务时在 targets 数组中指定的相应 URL

result.pins_count
integer

相关 page_url 的 Pin 数量Pinterest 上的 Pin对应内容保存;此字段显示使用 Pinterest Save Button 从相关 page_url 保存内容的次数