Felo API PlatformFelo API Platform
Tất cả endpoint của DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Tác vụ Pinterest mạng xã hội trực tiếp

Máy chủ:https://openapi.felo.ai
Thư viện client

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

Tác vụ Pinterest mạng xã hội trực tiếp

​

Số lần mỗi targets đã được ghim trên Pinterest. Trả về type, page_url và pins_count cho mỗi URL. Được bọc trong envelope của DataForSEO: dữ liệu nằm trong tasks[0].result, kết quả trong tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. Nhận danh sách nên có thể kiểm tra toàn bộ các trang của một site trong một lần gọi. Để lấy nội dung Pinterest thay vì số đếm, server pinterest đọc trực tiếp nền tảng.

Tham chiếu giá

  • Cách tính: chi phí phản hồi được báo cáo.
  • Ước tính tham chiếu mỗi yêu cầu: 0,2428 USD.
  • Hệ số tham chiếu cho khách hàng: 1,0. Không áp dụng lại hệ số này cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Phần thân
bắt buộc
application/json
  • Kiểu: array object[]
    • targets
      Kiểu: array string[]
      bắt buộc

      URL mục tiêu trường bắt buộc trang đích phải được chỉ định bằng URL tuyệt đối (bao gồm http:// hoặc https://) ví dụ: https://dataforseo.com/Lưu ý: bạn có thể chỉ định tối đa 10 mục tiêu. Bạn sẽ bị tính phí cho từng URL bạn chỉ định trong mảng này

    • tag
      Kiểu: string

      mã định danh tác vụ do người dùng xác định trường tùy chọn giới hạn ký tự là 255 bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả bạn sẽ thấy giá trị tag đã chỉ định trong đối tượng data của phản hồi

Phản hồi
  • 200
    Kiểu: object

    Phản hồi thành công

    • result
      Kiểu: array string[]

      mảng kết quả

    • result.page_url
      Kiểu: string

      URL của trang mà dữ liệu được cung cấp cho URL tương ứng bạn đã chỉ định trong mảng targets khi thiết lập tác vụ

    • result.pins_count
      Kiểu: integer

      số ghim cho page_url liên quan ghim trên Pinterest tương ứng với lượt lưu nội dung; trường này hiển thị số lượt lưu nội dung được thực hiện từ page_url liên quan bằng Pinterest Save Button

    • result.type
      Kiểu: string

      loại phần tử = ‘social_media_pinterest_item’

    • tasks
      Kiểu: array string[]

      mảng tác vụ

    • tasks.cost
      Kiểu: number

      chi phí của tác vụ, USD

    • tasks.data
      Kiểu: object

      chứa cùng các tham số bạn đã chỉ định trong yêu cầu POST

    • tasks.id
      Kiểu: string

      mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID

    • tasks.path
      Kiểu: array string[]

      đường dẫn URL

    • tasks.result_count
      Kiểu: integer

      số phần tử trong mảng result

    • tasks.status_code
      Kiểu: integer

      mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000

    • tasks.status_message
      Kiểu: string

      thông báo thông tin của tác vụ

    • tasks.time
      Kiểu: string

      thời gian thực thi, giây

    • version
      Kiểu: string

      phiên bản hiện tại của API

    • version.cost
      Kiểu: number

      tổng chi phí tác vụ, USD

    • version.status_code
      Kiểu: integer

      mã trạng thái chung bạn có thể tìm thấy danh sách đầy đủ các mã phản hồi tại đây Lưu ý: chúng tôi đặc biệt khuyên thiết kế hệ thống cần thiết để xử lý các điều kiện ngoại lệ hoặc lỗi liên quan

    • version.status_message
      Kiểu: string

      thông báo thông tin chung bạn có thể tìm thấy danh sách đầy đủ các thông báo thông tin chung tại đây

    • version.tasks_count
      Kiểu: integer

      số tác vụ trong mảng tasks

    • version.tasks_error
      Kiểu: integer

      số tác vụ trong mảng tasks được trả về kèm lỗi

    • version.time
      Kiểu: string

      thời gian thực thi, giây

    application/json
  • 400

    Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

  • 401

    Cần có khóa API Felo hợp lệ.

  • 402

    Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

  • 403

    Tài khoản không được phép thực hiện thao tác này.

  • 429

    Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

  • 502

    Dịch vụ không thể hoàn tất yêu cầu.

  • 503

    API hoặc dịch vụ thanh toán tạm thời không khả dụng.

  • 504

    Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

  • default

    Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

    application/json
Request Example for post/v1/beta/dataforseo/business_data/social_media/pinterest/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/social_media/pinterest/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      ""
    ],
    "tag": ""
  }
]'
{
  "version": "string",
  "version.status_code": 1,
  "version.status_message": "string",
  "version.time": "string",
  "version.cost": 1,
  "version.tasks_count": 1,
  "version.tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "result": [
    "string"
  ],
  "result.type": "string",
  "result.page_url": "string",
  "result.pins_count": 1
}
Live Social Media Pinterest Tasks