社交媒体互动包（Facebook Metrics）

通过统一 API 拉取数据（全站接口相同，仅替换 slug）。

1. 1
   获取凭证

   登录 → 购买 → 在 申请 API Key 签发密钥（仅显示一次）

2. 2
   发起请求

   GET /api/v1/data/retail-facebook-metrics/rows?page=1&size=10，Header：X-API-Key

3. 3
   解析响应

   从 JSON 的 rows 取数据，用 total 翻页

4. 4
   处理错误

   401 密钥无效 · 403 未购买/无权 · 400 参数错误 · 429 过频 · 502 上游失败

完整 API 文档 →

{
  "fields": [
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Page total likes",
      "nullable": false,
      "nunique": 90
    },
    {
      "dtype": "str",
      "is_label": false,
      "kind": "numeric",
      "name": "Type",
      "nullable": false,
      "nunique": 4
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Category",
      "nullable": false,
      "nunique": 3
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Post Month",
      "nullable": false,
      "nunique": 12
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Post Weekday",
      "nullable": false,
      "nunique": 7
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Post Hour",
      "nullable": false,
      "nunique": 22
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "Paid",
      "nullable": true,
      "nunique": 2
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Lifetime Post Total Reach",
      "nullable": false,
      "nunique": 485
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Lifetime Post Total Impressions",
      "nullable": false,
      "nunique": 494
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Lifetime Engaged Users",
      "nullable": false,
      "nunique": 414
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Lifetime Post Consumers",
      "nullable": false,
      "nunique": 422
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Lifetime Post Consumptions",
      "nullable": false,
      "nunique": 440
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Lifetime Post Impressions by people who have liked your Page",
      "nullable": false,
      "nunique": 491
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Lifetime Post reach by people who like your Page",
      "nullable": false,
      "nunique": 469
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Lifetime People who have liked your Page and engaged with your post",
      "nullable": false,
      "nunique": 382
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "comment",
      "nullable": false,
      "nunique": 46
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "like",
      "nullable": true,
      "nunique": 257
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "share",
      "nullable": true,
      "nunique": 88
    },
    {
      "dtype": "int64",
      "is_label": true,
      "kind": "numeric",
      "name": "Total Interactions",
      "nullable": false,
      "nunique": 280
    }
  ],
  "format": "csv",
  "label_column": "Total Interactions",
  "license_hint": "CC BY 4.0",
  "source_name": "Facebook Metrics (UCI)",
  "source_url": "https://archive.ics.uci.edu/dataset/368/facebook+metrics"
}

路径中的 slug 换成已购商品标识即可。完整说明见 API 文档。

curl -H "X-API-Key: ds_你的密钥" \
  "https://www.dataocean.zhixxing.cn/api/v1/data/retail-facebook-metrics/rows?page=1&size=10"

import requests

r = requests.get(
    "https://www.dataocean.zhixxing.cn/api/v1/data/retail-facebook-metrics/rows",
    headers={"X-API-Key": "ds_你的密钥"},

    params={"page": 1, "size": 10},

    timeout=30,
)
r.raise_for_status()
print(r.json())

const apiKey = "ds_你的密钥";
const url = new URL("https://www.dataocean.zhixxing.cn/api/v1/data/retail-facebook-metrics/rows");

url.searchParams.set("page", "1");
url.searchParams.set("size", "10");


const resp = await fetch(url, {
  headers: { "X-API-Key": apiKey },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const payload = await resp.json();
console.log(payload);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.dataocean.zhixxing.cn/api/v1/data/retail-facebook-metrics/rows?page=1&size=10"))
    .header("X-API-Key", "ds_你的密钥")
    .GET()
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET",
		"https://www.dataocean.zhixxing.cn/api/v1/data/retail-facebook-metrics/rows?page=1&size=10", nil)
	req.Header.Set("X-API-Key", "ds_你的密钥")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.StatusCode, string(body))
}

using System.Net.Http;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "ds_你的密钥");
var json = await client.GetStringAsync("https://www.dataocean.zhixxing.cn/api/v1/data/retail-facebook-metrics/rows?page=1&size=10");
Console.WriteLine(json);