Tripadvisor 搜索已完成任务列表

GET /v3/business_data/tripadvisor/search/tasks_ready

本接口使用 GET 方法，通过以下路径获取 Tripadvisor 搜索任务中已完成但尚未领取的任务：

GET /v3/business_data/tripadvisor/search/tasks_ready

如果未 postback_url，可通过本接口获取所有已完成任务的 id，再调用任务结果接口获取结果。

接口说明

通用路径

如需根据指定搜索引擎获取已完成任务，可使用以下路径 $se 替换为搜索引擎名称：

http

GET /v3/business_data/$se/tasks_ready

获取 Business Data API 下所有已完成任务：

http

GET /v3/business_data/tasks_ready

当前 Tripadvisor 搜索任务对应的接口路径为：

http

GET /v3/business_data/tripadvisor/search/tasks_ready

使用限制

已完成任务队列存在少量更新延迟，高并发场景下可能无法立即获取刚完成的任务。
每分钟最多调用 20 次。
每次调用最多返回过去 3 天完成的 1000 个任务。
任务被领取后，将从已完成任务列表中移除。
任务完成后 3 天仍未领取，也不会继续出现在列表中。
如果任务了 postback_url，正常推送成功的任务不会出现在本列表中。
只有当推送请求失败，且接收服务器返回的 HTTP 状态码小于 200 或大于 300 时，该任务才可能重新出现在列表中。
由于队列存在更新延迟，如果系统每分钟需要领取 1000 个任务，建议使用回调或推送机制；本接口可用于补获取推送失败任务的 ID。

计费说明

获取已完成任务列表本身不收费。
任务结果的成本在提交任务时产生，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
本接口响应中的 cost 字段（平台原始 USD 成本兼容字段）通常为 0。

请求参数

本接口无需请求参数。

请求头

http

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

响应字段

接口返回 JSON 数据 tasks 数组。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	接口级状态码，完整状态码列表请参考 `/v3/appendix/errors`
`status_message`	string	接口级提示信息
`time`	string	接口执行耗时，单位为秒
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量
`tasks`	array	已完成任务列表

`tasks` 数组字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式
`status_code`	integer	任务状态码，通常在 `10000`-`60000` 范围；完整列表请参考 `/v3/appendix/errors`
`status_message`	string	任务状态说明
`time`	string	任务执行耗时，单位为秒
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的结果数量
`path`	array	任务请求路径
`data`	object	创建任务时传的请求参数
`result`	array	已完成任务的信息列表

`result` 数组字段

字段	类型	说明
`id`	string	已完成任务的唯一标识，UUID 格式
`se`	string	创建任务时指定的搜索引擎，当前为 `tripadvisor`
`se_type`	string	搜索引擎类型
`date_posted`	string	任务提交时间，UTC 格式
`tag`	string	用户自定义任务标识
`endpoint`	string	获取该任务详细结果的接口路径

请求示例

cURL

bash

curl --location --request GET \
  "https://api.seermartech.cn/v3/business_data/tripadvisor/search/tasks_ready" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json"

PHP

php

<?php

require('RestClient.php');

$api_url = 'https://api.seermartech.cn/';
$client = new RestClient($api_url, null, null, null, [
    'Authorization: Bearer smt_live_YOUR_KEY',
    'Content-Type: application/json'
]);

try {
    // 获取已完成但尚未领取的 Tripadvisor 搜索任务
    // GET /v3/business_data/tripadvisor/search/tasks_ready
    $result = $client->get('/v3/business_data/tripadvisor/search/tasks_ready');

    print_r($result);
    // 在此处处理返回结果
} catch (RestClientException $e) {
    echo "\n";
    print "HTTP 状态码: {$e->getHttpCode()}\n";
    print "错误码: {$e->getCode()}\n";
    print "错误信息: {$e->getMessage()}\n";
    print $e->getTraceAsString();
    echo "\n";
}

$client = null;
?>

TypeScript

typescript

import axios from 'axios';

axios({
  method: 'get',
  url: 'https://api.seermartech.cn/v3/business_data/tripadvisor/search/tasks_ready',
  headers: {
    'Authorization': 'Bearer smt_live_YOUR_KEY',
    'Content-Type': 'application/json'
  }
})
  .then((response) => {
    // 处理返回数据
    console.log(response.data);
  })
  .catch((error) => {
    console.error('请求失败:', error.response?.data || error.message);
  });

Python

python

import requests

url = "https://api.seermartech.cn/v3/business_data/tripadvisor/search/tasks_ready"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    result = response.json()
    print(result)
    # 在此处处理已完成任务列表
else:
    print(f"请求失败，HTTP 状态码: {response.status_code}")
    print(response.text)

C#

csharp

using Newtonsoft.Json;
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

namespace SeerMarTechDemos
{
    public static partial class Demos
    {
        public static async Task BusinessDataTripadvisorSearchTasksReady()
        {
            using var httpClient = new HttpClient
            {
                BaseAddress = new Uri("https://api.seermartech.cn/")
            };

            httpClient.DefaultRequestHeaders.Authorization =
                new AuthenticationHeaderValue("Bearer", "smt_live_YOUR_KEY");

            // 获取已完成但尚未领取的 Tripadvisor 搜索任务
            // GET /v3/business_data/tripadvisor/search/tasks_ready
            var response = await httpClient.GetAsync(
                "/v3/business_data/tripadvisor/search/tasks_ready"
            );

            var content = await response.Content.ReadAsStringAsync();
            var result = JsonConvert.DeserializeObject<dynamic>(content);

            if ((int)result.status_code == 20000)
            {
                Console.WriteLine(result);
            }
            else
            {
                Console.WriteLine(
                    $"请求失败。错误码: {result.status_code}，信息: {result.status_message}"
                );
            }
        }
    }
}

响应示例

json

{
  "version": "0.1.20210917",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1630 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "090c8e42-1234-5678-9012-abcdef123456",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1200 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "business_data",
        "tripadvisor",
        "search",
        "tasks_ready"
      ],
      "data": {
        "se_type": "search",
        "se": "tripadvisor",
        "api": "business_data",
        "function": "search"
      },
      "result": [
        {
          "id": "090c8e42-1234-5678-9012-abcdef123456",
          "se": "tripadvisor",
          "se_type": "search",
          "date_posted": "2024-01-15 08:30:00 +00:00",
          "tag": "tripadvisor-search-demo",
          "endpoint": "/v3/business_data/tripadvisor/search/task_get"
        }
      ]
    }
  ]
}

错误处理

建议客户端根据以下字段判断请求是否成功：

顶层 status_code
任务级 tasks[].status_code
对应的 status_message

当状态码为 20000 时，通常表示请求成功。完整状态码及错误信息请参考：

text

/v3/appendix/errors

对于批量任务处理系统，建议：

根据 tasks_count 判断返回任务数量。
检查 tasks_error 和每个任务的 status_code。
保存每个已完成任务的 id 和 endpoint。
使用任务结果接口领取数据。
对因队列延迟暂未返回的任务执行延迟重试，但不要任务完成后的 3 天保留期限。

实用场景

轮询已完成任务：定期获取 Tripadvisor 搜索任务 ID，并批量领取结果，降低逐个查询任务状态的请求开销。
补偿失败推送任务：筛选未成功送达回调服务的任务，商户评价或地点搜索数据丢失。
构建任务调度队列：根据返回的 date_posted 和 endpoint 组织结果领取顺序，提高异步采集系统的处理效率。
监控数据采集延迟：对比任务提交时间、任务完成时间和领取时间，识别高并发下的队列积压问题。
支撑 Tripadvisor 竞品分析：批量领取地点、商户或搜索结果任务，为本地 SEO 排名、竞品覆盖度和商户声誉分析提供数据。

Tripadvisor 搜索已完成任务列表 ​

接口说明 ​

通用路径 ​

使用限制 ​

计费说明 ​

请求参数 ​

请求头 ​

响应字段 ​

顶层字段 ​

tasks 数组字段 ​

result 数组字段 ​

请求示例 ​

cURL ​

PHP ​

TypeScript ​

Python ​

C# ​

响应示例 ​

错误处理 ​

实用场景 ​

Tripadvisor 搜索已完成任务列表

接口说明

通用路径

使用限制

计费说明

请求参数

请求头

响应字段

顶层字段

`tasks` 数组字段

`result` 数组字段

请求示例

cURL

PHP

TypeScript

Python

C#

响应示例

错误处理

实用场景