Felo API PlatformFelo API Platform
全部 DataForSEO 端點
v0.2.0-beta
OpenAPI 3.1.0

即時社交媒體 Pinterest 任務

Felo API Support
MIT
伺服器:https://openapi.felo.ai
用戶端程式庫
Shell Curl

DataForSEO

​

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

DataForSEO 操作

即時社交媒體 Pinterest 任務

​

每個 targets 在 Pinterest 上被 Pin 的次數。依 URL 回傳 type、page_url 與 pins_count。採用 DataForSEO 的信封結構：資料位於 tasks[0].result，結果狀態位於 tasks[0].status_code——被拒絕的請求仍會回傳 HTTP 200。它接受清單，因此一次呼叫即可檢查整個網站的頁面。若要取得 Pinterest 內容而非計數，pinterest 伺服器會直接讀取該平台。

計費參考

  • 計量方式：依回報的回應成本計量。
  • 參考請求估算：0.2428 美元。
  • 參考客戶倍率：1.0。不得對已結算的客戶金額再次套用。

僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。

請求本文
必填
application/json
  • 類型: array object[]
    • targets
      類型: array string[]
      必填

      目標 URL 必填欄位 目標頁面應使用絕對 URL 指定（包含 http:// 或 https://）範例：https://dataforseo.com/注意： 最多可指定 10 個目標。你將按此陣列中指定的每個 URL 計費

    • tag
      類型: string

      使用者自訂任務識別碼 選填欄位 字元限制為 255 可使用此參數識別任務，並將其與結果比對 你將在回應的 data 物件中找到指定的 tag 值

回應
  • 200
    類型: object

    成功回應

    • result
      類型: array string[]

      結果陣列

    • result.page_url
      類型: string

      提供資料所對應頁面的 URL 即設定任務時你在 targets 陣列中指定的對應 URL

    • result.pins_count
      類型: integer

      相關 page_url 的 Pin 數量 Pinterest 上的 Pin 對應內容收藏；此欄位顯示使用 Pinterest Save Button 從相關 page_url 發起的內容收藏次數

    • result.type
      類型: string

      元素類型 = ‘social_media_pinterest_item’

    • tasks
      類型: array string[]

      任務陣列

    • tasks.cost
      類型: number

      任務費用，美元

    • tasks.data
      類型: object

      包含你在 POST 請求中指定的相同參數

    • tasks.id
      類型: string

      我們系統中的唯一任務識別碼 採用 通用唯一識別碼（UUID） 格式

    • tasks.path
      類型: array string[]

      URL 路徑

    • tasks.result_count
      類型: integer

      result 陣列中的元素數量

    • tasks.status_code
      類型: integer

      任務狀態代碼 由 DataForSEO 產生；取值範圍為：10000-60000

    • tasks.status_message
      類型: string

      任務資訊訊息

    • tasks.time
      類型: string

      執行時間，秒

    • version
      類型: string

      目前 API 版本

    • version.cost
      類型: number

      任務總費用，美元

    • version.status_code
      類型: integer

      通用狀態代碼 完整的狀態代碼清單見此處 注意： 強烈建議設計必要的系統來處理相關例外或錯誤情況

    • version.status_message
      類型: string

      通用資訊訊息 完整的通用資訊訊息清單見此處

    • version.tasks_count
      類型: integer

      位於 tasks 陣列中的任務數量

    • version.tasks_error
      類型: integer

      傳回錯誤狀態的 tasks 陣列中的任務數量

    • version.time
      類型: string

      執行時間，秒

    application/json
  • 400

    無法處理該要求。請檢查請求參數。

  • 401

    需要有效的 Felo API 金鑰。

  • 402

    由於未符合計費要求，要求無法繼續。

  • 403

    該帳戶無權執行此操作。

  • 429

    已達到要求或支出上限。

  • 502

    服務無法完成該要求。

  • 503

    API 或計費服務暫時無法使用。

  • 504

    服務在處理要求時逾時。

  • default

    錯誤回應；上游透傳回應可能採用供應商格式

    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

需要協助嗎？