PartnerBoost-API-Dokumentation

Integrieren Sie Ihre Systeme in die PartnerBoost-Plattform für das Partnermanagement. Über unsere API können Sie Transaktionen verwalten, Berichte erstellen, Werbemittel bearbeiten und Ihren Produkt-Datafeed programmgesteuert verwalten.

Lesen Sie den Leitfaden
Marken-KI

Übersicht

Die händlerseitigen Funktionen von PartnerBoost wurden offiziell in die OpenClaw-Plattform integriert. Durch die Nutzung der Funktionen „KI-Gehirn + automatisierter Betrieb“ von OpenClaw bietet sie Händlern im grenzüberschreitenden E-Commerce operative Dienstleistungen im Stil eines digitalen KI-Mitarbeiters. Händler können Auftragsdatenabfragen, Leistungsanalysen, die Überprüfung von Kanaleffekten, Rechnungsprüfungen, das Partner-Medienmanagement und andere Vorgänge schnell und einfach durch Anweisungen in natürlicher Sprache erledigen, ohne sich manuell im Backend anmelden zu müssen, um Berichte zu exportieren. Dies verbessert die Effizienz der Affiliate-Marketing-Abläufe erheblich und ermöglicht einen Effizienzsprung vom manuellen Betrieb hin zur intelligenten Interaktion.

Anleitung – OpenClaw

OpenClaw Skill 安装指引

一、获取 API Key

在开始查询前，请先准备好 PARTNERBOOST_API_KEY：

  1. 主账号：登录 PartnerBoost（PB）平台，在「设置」或「API 管理」页面直接查看并复制 API Key。
  2. 子账号：联系主账号管理员，在 PB 平台内为你分配 API Key。

二、创建飞书企业应用

  1. 进入飞书开放平台：https://open.feishu.cn/app
  2. 点击创建企业自建应用，按指引完成基础创建流程。 飞书开放平台：企业自建应用，创建企业自建应用按钮
  3. 左侧菜单栏点击添加应用能力，在右侧找到机器人并点击「添加」。 飞书开放平台：添加应用能力，机器人卡片与添加按钮
  4. 左侧菜单栏点击凭证与基础信息，复制 App ID 及 App Secret 备用。 飞书开放平台：凭证与基础信息，应用凭证 App ID 与 App Secret

三、在阿里云创建 OpenClaw 实例

  1. 阿里云搜索「OpenClaw」，进入购买页面：https://www.aliyun.com/benefit/scene/openclaw 阿里云 OpenClaw 场景页：快速部署 OpenClaw
  2. 选择适配配置，完成购买。 阿里云轻量应用服务器：选择 OpenClaw 应用镜像与套餐并完成购买
  3. 等待实例创建完成，点击管理 OpenClaw。 阿里云轻量应用服务器列表：点击实例上的「管理 OpenClaw」
  4. 依次完成 OpenClaw 使用步骤 1→2→3，填入飞书应用的 App ID 和 App Secret。 阿里云 OpenClaw 应用详情：使用步骤 1→2→3 与飞书通讯配置（App ID、App Secret）

四、安装 PartnerBoost Brand Skill

  1. 打开飞书，搜索并找到已创建的 OpenClaw 应用机器人。
  2. 发送以下指令（将 PARTNERBOOST_API_KEY 替换为你的实际 Key）：
    帮我安装这个技能 https://github.com/partnerboost-tech-team/partnerboost-brand 然后初始化他，我的key是 PARTNERBOOST_API_KEY
    飞书与 OpenClaw 机器人对话：发送安装指令与技能安装成功提示
  3. 等待机器人提示技能安装成功。
  4. 发送指令重启，重启 OpenClaw 使配置生效。 飞书：发送重启指令与 OpenClaw 机器人确认在线
  5. 重启完成后即可正常使用，支持查询订单、合作媒体、业绩数据等功能。

PartnerBoost OpenClaw Skill Installation Guide

Content generated by AI

1. Obtain Your API Key

Before starting, ensure you have your PARTNERBOOST_API_KEY ready:

  • Primary Account: Log in to the PartnerBoost (PB) platform. Go to the "Settings" or "API Management" page to view and copy your API Key.
  • Sub-Account: Contact your primary account administrator to have an API Key assigned to you within the PB platform.

2. Create a Discord Bot

  1. Go to the Discord Developer Portal: https://discord.com/developers/applications
  2. Click "New Application", enter a name, and create it.
  3. Navigate to the "Bot" tab in the left sidebar:
    • Click "Reset Token" to generate your Bot Token. (Copy and save it immediately; it will not be shown again).
    • Under the "Privileged Gateway Intents" section, toggle ON the MESSAGE CONTENT INTENT (This is required for the bot to read your commands).
  4. Navigate to "OAuth2" → "URL Generator":
    • Scopes: Select bot.
    • Bot Permissions: Select Administrator (or specific messaging permissions).
    • Copy the generated URL, paste it into your browser, and invite the bot to your Discord server.
  5. Go to "General Information" and copy the Application ID (Client ID) for later use.

3. Create an OpenClaw Instance on AWS

  1. Log in to the AWS Management Console and navigate to the EC2 dashboard.
  2. Launch Instance:
    • Name: OpenClaw-Server.
    • OS (AMI): Select Ubuntu 22.04 LTS (Recommended).
    • Instance Type: Select t3.medium (2 vCPU, 4GB RAM) or higher.
    • Security Group: Ensure ports TCP 80, 443, and the specific OpenClaw WebUI port are open.
  3. Deploy OpenClaw:
    • Connect to your instance via SSH and install Docker.
    • Pull and run the OpenClaw image.
  4. Initialization:
    • Access the OpenClaw WebUI via your instance's Public IP in a browser.
    • Enter your Discord Bot Token and Application ID during the setup steps.
    • Complete the basic configuration and dashboard initialization.

4. Install PartnerBoost Brand Skill

  1. Open Discord and go to the server where your OpenClaw bot is present.
  2. Send the following command to the bot (Replace [YOUR_API_KEY] with your actual key):

    Command:

    Please install this skill https://github.com/partnerboost-tech-team/partnerboost-brand and initialize it. My key is [YOUR_API_KEY]
  3. Wait for the bot to reply: "Skill installation successful."
  4. Send the command restart to apply the changes.
  5. Once restarted, the bot is ready. You can now query orders, affiliate partners, and performance data.

Anwendungsfälle

Anwendungsfall 1: Leistungsbeurteilung und Optimierung der Personalbesetzung

Anweisung: Überprüfen Sie die PB-Bestelldaten der letzten drei Monate und unterbreiten Sie Vorschläge zur Optimierung der Bestellungen.

KI-Funktion: Ruft automatisch Bestelldaten ab → analysiert den ROI über alle Kanäle hinweg → identifiziert Medien mit hoher Konversionsrate → gibt Empfehlungen für Provisionsanpassungen und die Optimierung der Platzierung.

Anwendungsfall 2: Auftragsüberwachung in Echtzeit

Beispielaufgabe: Wie entwickeln sich die jüngsten Bestellungen? Fassen Sie die erfolgreichsten Vertriebskanäle zusammen.

KI-Funktion: Erfasst wichtige Bestellkennzahlen → markiert ungewöhnliche Bestellungen (Rückerstattungen, verdächtige Transaktionen) → erstellt eine Liste hochwertiger Vertriebskanäle.

Anwendungsfall 3: Schnelle Rechnungsabfrage

Beispielanweisung: Überprüfe meine Rechnung vom letzten Monat.

KI-Funktion: Ruft Rechnungen für den ausgewählten Monat direkt ab → zeigt Provisionsdetails und Abrechnungsstatus an, ohne sich im Backend anzumelden.

Anwendungsfall 4: Verwaltung von Partnermedien

Beispielanweisung: Mit welchen Werbemedien arbeite ich derzeit zusammen?

KI-Funktion: Listet alle Partner-Werbemedien auf und stellt die Ressourcenstruktur übersichtlich dar.

Häufig gestellte Fragen

Frage 1: Wer kann PartnerBoost Skills nutzen?

A: Alle Händler, die PartnerBoost integriert haben, können es aktivieren.

Frage 2: Auf welche Daten kann die KI zugreifen?

A: Es unterstützt zentrale Betriebsdaten wie Auftragsdaten, Absatzvolumen, Konversionsrate, Kanalleistung, Rechnungsdaten und Partnermedien.

Frage 3: Wie wird die Datensicherheit gewährleistet?

A: Der gesamte Datenzugriff und alle Datenverarbeitungsvorgänge erfolgen im Rahmen der Händlerautorisierung unter Einhaltung der Sicherheitsstandards der Plattform, und es werden keine Geschäftsdaten weitergegeben.

Frage 4: Was kann die KI außer der Abfrage von Daten noch tun?

A: Es kann Daten automatisch analysieren, Platzierungsvorschläge unterbreiten und ungewöhnliche Bestellungen überwachen. In Zukunft wird es die Erstellung von Kampagnen, die Auswahl von Influencern, die Erstellung von Marketingmaterialien und vieles mehr unterstützen.

Frage 5: Was passiert, wenn die Konfiguration fehlschlägt oder die Funktion nicht verfügbar ist?

A: Bitte überprüfen Sie, ob Sie bei ClawHub angemeldet sind und die PartnerBoost-Fähigkeiten korrekt hinzugefügt haben. Sollte das Problem weiterhin bestehen, wenden Sie sich bitte an den PartnerBoost-Kundendienst oder Ihren Kundenbetreuer.

Marken-API

Authentifizierung

Die PartnerBoost-API unterstützt derzeit eine Reihe verschiedener Aktionen. Alle Anfragen sollten als HTTPS-GET- oder POST-Anfrage (JSON) an folgende Adresse gesendet werden:

https://app.partnerboost.com/api/brand

Erforderliche Parameter

  • Gebot - Ihre Marken-Identifikationsnummer
  • Token - Einmaliger Token, der bei der Einrichtung des Kontos für die API-Nutzung vergeben wird
  • Aktion - Eine der unterstützten Aktionen
  • Version - Derzeit 1.0

Erforderliche Kopfzeilen

  • Inhaltstyp - application/json
  • X-PARTNERBOOST-DATE - Das aktuelle Datum in UTC (Universal Time Coordinated)
  • X-PARTNERBOOST-AUTHENTIFIZIERUNG - Der berechnete Authentifizierungs-Hash

Authentifizierungs-Hash

Der Authentifizierungs-Hash ist ein SHA-256-Hash im 64-stelligen Hexadezimalformat der Zeichenfolge:

IhrAPIToken;APIActionValue;AktuellesDatumimUTC-Format;IhrAPISecret
Beispiel

Für die folgenden Werte:

  • API-Aktion: order/new
  • Token: a25fb1225425ae360ec2922286e7bd01
  • API-Schlüssel: 65906f8ecdaf1147bca07dbebf9d29656317a2913783b6ac6f08c6d5713dca5c
  • UTC-Datum: Fr, 07. Jan. 2022 07:21:16 GMT
  • String zu Hash: a25fb1225425ae360ec2922286e7bd01;order/new;Fr, 07. Jan. 2022 07:21:16 GMT;65906f8ecdaf1147bca07dbebf9d29656317a2913783b6ac6f08c6d5713dca5c

Korrekte HTTP-Header

  • X-PARTNERBOOST-DATE: Fr, 07. Jan. 2022 07:21:16 GMT
  • X-PARTNERBOOST-AUTHENTICATION: c0603ea2f4bd66eaac5e6fbbd2093ea6426d7e13e0a8cc4f5550368f55f7e64a

Transaktions-API

POST Bestellung/Neu Neue Transaktion erstellen
Schlüssel Titel Beispiel Erforderlich Typ
Bestellnummer Ihre individuelle Bestellnummer 201000000001 Ja Zeichenkette
pbtid PartnerBoost-Klick-Track-Code x_xxxxx Nein Zeichenkette
ist_Neukunde Ist Neukunde der Marke falsch Nein bool
uid Die Identität des Nutzers in der Marke 453215 Nein Zeichenkette
Währung Währung der Bestellung USD Ja Zeichenkette
trans_time Bearbeitungszeit der Bestellung Do, 20. Jan. 2022, 05:27:30 Uhr GMT Ja Zeichenkette
Betrag Tatsächlicher Bestellbetrag 111.55 Nein doppelt
Menge Anzahl der Produkte 1 Nein int
Anmerkung Eine beliebige Nachricht Nein Zeichenkette
Gutscheincode Durch Kommas getrennte Liste von Gutscheincodes ZVKD234,ZVKA111 Nein Zeichenkette
skus SKU-Liste (erforderlich, wenn die Bestellung eine SKU enthält) Array Nein Array
Demo anfordern
{ "order_number": "RMD17ea9a09be7c4bd4101aa3d21df80b47", "currency": "CNY", "trans_time": "Thu, 20 Jan 2022 05:27:30 GMT", "pbtid": "ldc_xdw3", "skus": [ { "id": "1df80b47", "name": "Mi book", "amount": 2776, "quantity": 12 } ] }
Demo zur Reaktion
{ "code": 0, "data": "210120052732256X22", "msg": "success" }
POST Bestellung stornieren/ungültig machen Transaktion stornieren
Schlüssel Titel Beispiel Erforderlich Typ
Bestellnummer Ihre individuelle Bestellnummer 201000000001 Ja Zeichenkette
Demo anfordern
{ "order_number": "RMD1a04ccbedbe2cde84d20cceb5f22c234" }
Demo zur Reaktion
{ "code": 0, "data": "", "msg": "success" }
POST Auftrag/wirksam Gültige Transaktion
Schlüssel Titel Beispiel Erforderlich Typ
Bestellnummer Ihre individuelle Bestellnummer 201000000001 Ja Zeichenkette
Demo anfordern
{ "order_number": "RMD1a04ccbedbe2cde84d20cceb5f22c234" }
Demo zur Reaktion
{ "code": 0, "data": "", "msg": "success" }
POST Bestellung/Bonus Bonus an den Herausgeber zahlen
Schlüssel Titel Beispiel Erforderlich Typ
medium_id Angaben zum Herausgeber LDC000123 Ja Zeichenkette
Währung Währung der Bestellung USD Ja Zeichenkette
trans_time Bearbeitungszeit der Bestellung Do, 20. Jan. 2022, 05:27:30 Uhr GMT Ja Zeichenkette
Provision Provision für den Verlag 11.15 Ja doppelt
Anmerkung Eine beliebige Nachricht Nein Zeichenkette
Demo anfordern
{ "medium_id": "LDC0012346", "currency": "CNY", "trans_time": "Thu, 20 Jan 2022 05:27:30 GMT", "commission": 416.4 }
Demo zur Reaktion
{ "code": 0, "data": "210120052732256X22", "msg": "success" }

Berichts-API

POST report/clicks_list Klickliste
Schlüssel Titel Beispiel Erforderlich Typ
Startzeit Startzeitstempel 1650351153 Nein int
Endzeit Endzeitstempel 1670351153 Nein int
erstens Erstens 0 Nein int
Seitengröße Seitengröße von 20 bis 100 20 Nein int
publisher_id Verlags-ID Nein Zeichenkette
Kanal-ID Kanal-ID Nein Zeichenkette
Demo anfordern
{ "first": 720078 }
Demo zur Reaktion
{ "code": 0, "data": { "pageInfo": { "hasNextPage": true, "endCursor": "720131", "startCursor": "720107" }, "list": [ { "id": "720107", "pbtid": "pb_xxt0", "ip": "217.143.18.13", "location": "CA", "referer": "https://example.com", "usource": "PC", "useragent": "Mozilla/5.0...", "publisher_id": "50153", "publisher_name": "meimei", "channel_id": "4493", "channel_name": "yuyao", "landing_page": "", "created_timestamp": "1648692632", "created_time": "Thu, 31 Mar 2022 02:10:32 GMT" } ] }, "msg": "success" }
POST Bericht/Klickdetails Klickdetails
Schlüssel Titel Beispiel Erforderlich Typ
id Transfer-ID (entweder „id“ oder „pbtid“ muss angegeben werden) 720078 Nein int
pbtid Tracking-Flag aus der Landing-URL (entweder „id“ oder „pbtid“ ist erforderlich) pb_xxxx Nein Zeichenkette
Demo anfordern
{ "id": 720112 }
Demo zur Reaktion
{ "code": 0, "data": { "id": "720107", "pbtid": "pb_xxt0", "ip": "217.143.18.13", "location": "CA", "referer": "https://app.partnerboost.com/publisher/payments/transaction_inquiries?act=new", "usource": "PC", "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.60 Safari/537.36", "publisher_id": "50153", "publisher_name": "meimei", "channel_id": "4493", "channel_name": "yuyao", "landing_page": "", "created_timestamp": "1648692632", "created_time": "Thu, 31 Mar 2022 02:10:32 GMT" }, "msg": "success" }
POST Bericht/Auftragsliste Bestellliste
Schlüssel Titel Beispiel Erforderlich Typ
Startzeit Zeitstempel der Transaktion 1650351153 Nein int
Endzeit Zeitstempel der Transaktion 1670351153 Nein int
Seitenzahl Seitenzahl 1 Nein int
Seitengröße Seitengröße von 20 bis 100 20 Nein int
sort_dir enum(absteigend, aufsteigend), Standard ist absteigend Beschreibung Nein enum
sort_col enum(Transaktions-ID, Provision, Betrag) transid Nein enum
Status enum(new, void, effective) Nein enum
Typ Transaktionsart Nein enum
Demo anfordern
{ "status": "effective" }
Demo zur Reaktion
{ "code": 0, "msg": "success", "data": { "total": "1", "list": [ { "id": "316", "order_id": "12123121", "publisher_id": 50034, "channel_id": 4480, "coupon_code": "", "transaction_type": "trans", "status": "effective", "transaction_time": "Wed, 20 Apr 2022 08:04:23 GMT", "transaction_timestamp": 1650441863, "track_code": "", "currency": "USD", "sale_amount": 135.7, "network_fee": 3.05, "commission": 20.35, "total_spend": 23.4, "ori_currency": "CNY", "ori_sale_amount": 864.36, "ori_network_fee": 19.44, "ori_commission": 129.65, "ori_total_spend": 149.09, "skus": [ { "sku": "b219ac3d", "status": "effective", "quantity": 12, "commission_id": "0", "currency": "USD", "sale_amount": 68.64, "network_fee": 1.54, "commission": 10.29, "total_spend": 11.83, "ori_currency": "CNY", "ori_sale_amount": 437.22, "ori_network_fee": 9.83, "ori_commission": 65.58, "ori_total_spend": 75.41 } ] } ] } }
POST report/transaction_list Transaktionsliste
Schlüssel Titel Beispiel Erforderlich Typ
Grenze Anzahl pro Seite (max. 200, Standard 100) 100 Nein int
Cursor Cursor für die Paginierung 1 Ja Zeichenkette
Startdatum Startdatum (JJJJMMTT) 20241101 Nein Zeichenkette
Enddatum Enddatum (JJJJMMTT) 20241101 Nein Zeichenkette
Bestellstatus Bestellstatus neu, ungültig, gemischt, gesperrt, bezahlt Nein Zeichenkette
Artikelnummer-Status Status der Artikelnummer/ASIN neu, ungültig, gesperrt, bezahlt Nein Zeichenkette
Transaktionsart Transaktionsart Bonus, manuell hinzugefügt, normal Nein Zeichenkette
publisher_id Verlags-ID Nein Zeichenkette
Gruppen-ID Den Verlagen zugewiesene Gruppen-ID 323 Nein Zeichenkette
Demo anfordern
{ "limit": 100, "cursor": "1", "start_date": "20241101", "end_date": "20241130", "order_status": "locked" }
Demo zur Reaktion
{ "code": 0, "msg": "success", "data": { "list": [ { "order_id": "C1TZX-95VVFA5R95", "order_status": "locked", "date": "2024-11-07 05:00:00", "currency": "USD", "publisher_id": "180716", "publisher_name": "haar1", "sku_list": [ { "sku_status": "locked", "sku": "B0CJM2W42K", "quantity": "2", "sales_amount": "100.00", "commission": "27.00" } ] } ], "count": 1, "cursor": null } }

Kreative API

POST Kreativ/Liste Kreativliste
Schlüssel Titel Beispiel Erforderlich Typ
Typ Typ BILD/TEXT/GUTSCHEIN Ja Zeichenkette
Status Status Geplant/Aktiv/Abgelaufen Nein Array
Datenschutz Berechtigung ÖFFENTLICH/PRIVAT Nein Array
Stichwort Stichwort Test Nein Zeichenkette
Seitenzahl Seitenzahl 1 Nein int
Seitengröße Seitengröße 10 Nein int
Demo anfordern
{ "type": "IMAGE", "status": ["Active"], "privacy": ["PUBLIC"], "keyword": "test", "page_num": 1, "page_size": 10 }
Demo zur Reaktion
{ "data": { "total_size": 1, "total_page": 1, "page_size": 28, "page_num": 1, "current_size": 1, "data": [ { "id": "132505", "mid": "partnerboost", "start_time": "1680241332", "end_time": "1682574132", "title": "test", "privacy": "PUBLIC", "type": "IMAGE", "category": "cate", "link": "https://www.example.com", "created_time": "1679636639", "updated_time": "1679636659", "deleted_time": "0", "is_deleted": "0", "status": "Active", "images": [ { "creative_id": "132505", "image_url": "https://example/img.png", "width": "2880", "height": "1800", "alternate": "", "size": "957112" } ] } ] }, "code": 0, "message": "ok" }
POST Kreativ/Erstellen Kreativmaterial hochladen
Schlüssel Titel Beispiel Erforderlich Typ
Typ Typ BILD/TEXT/GUTSCHEIN Ja Zeichenkette
Startzeit Startzeit 1680241332 Ja Zeichenkette
Endzeit Ende 1682574132 Ja Zeichenkette
Link Link (erforderlich, wenn type == TEXT) https://www.example.com Nein Zeichenkette
Inhalt Inhalt (erforderlich, wenn type == TEXT) Test Nein Zeichenkette
Bilder Bilder (erforderlich, wenn type == IMAGE) Array Nein Array
Titel Titel Test Nein Zeichenkette
Datenschutz Datenschutz ÖFFENTLICH/PRIVAT Nein Zeichenkette
Demo anfordern
{ "title": "bnane", "category": "cate", "privacy": "PUBLIC", "site_ids": [], "start_time": 1681282362, "end_time": 1683874362, "type": "TEXT", "images": [ { "width": 225, "height": 225, "url": "https://cdn-test.55haitao.com/data/upload/image/20230412/20230412160510_94131.jpeg", "size": 10500 } ], "link": "http://example.com", "highligh": [], "preview": null, "content": "test" }
Demo zur Reaktion
{ "code": 0, "data": [ 132508 ], "msg": "success" }
POST Erstellen/Bearbeiten Kreativ bearbeiten
Schlüssel Titel Beispiel Erforderlich Typ
id ID 132505 Ja Zeichenkette
Titel Titel Test Nein Zeichenkette
Startzeit Startzeit 1680241332 Nein Zeichenkette
Endzeit Ende 1682574132 Nein Zeichenkette
Datenschutz Datenschutz ÖFFENTLICH/PRIVAT Nein Zeichenkette
Demo anfordern
{ "id": "132505", "title": "test", "category": "cate", "privacy": "PUBLIC", "start_time": "1680241332", "end_time": "1682574132" }
Demo zur Reaktion
{ "code": 0, "data": null, "msg": "success" }

Datenfeed-API

POST datafeed/get_info Datenfeed-Informationen abrufen
Demo anfordern
{}
Demo zur Reaktion
{ "code": 0, "data": { "last_updated": "1653546984", "last_uploaded_time": "1653466305", "max_upload_num_per_month": "10", "num_products": "9", "fetch_url": "http://www.yousite.com/datafeed.xml", "fetch_period": "DAILY", "last_fetch_time": "1653552418", "last_fetch_status": "XML parse error", "updated_time": "1653882623", "parsing_files_num": 0, "uploaded_this_month": 8 }, "msg": "success" }
POST datafeed/update_setting Einstellungen für den Datenfeed aktualisieren
Schlüssel Titel Beispiel Erforderlich Typ
Abrufzeitraum Abrufzeitraum (NIE, TÄGLICH, WÖCHENTLICH, MONATLICH) TÄGLICH Ja Zeichenkette
fetch_url URL abrufen http://www.yousite.com/datafeed.xml Ja Zeichenkette
Demo anfordern
{ "fetch_period": "DAILY", "fetch_url": "http://www.yousite.com/datafeed.xml" }
Demo zur Reaktion
{ "code": 0, "data": null, "msg": "success" }
POST datafeed/update_product Produkt aktualisieren oder hinzufügen
Schlüssel Titel Beispiel Erforderlich Typ
Name Produktname Produktname Ja Zeichenkette
URL Produkt-URL http://www.yousite.com/product/1 Ja Zeichenkette
Bild Produktbild http://www.yousite.com/product/1.jpg Ja Zeichenkette
Artikelnummer Produkt-SKU (eindeutig) Artikelnummer Ja Zeichenkette
Preis Produktpreis 100 Ja Zahl
Währung Währungscode (ISO 4217) USD Ja Zeichenkette
Beschreibung Produktbeschreibung Produktbeschreibung Nein Zeichenkette
Kategorie Produktkategorie Kategorie Nein Zeichenkette
alter Preis Produkt Alter Preis 100 Nein Zahl
Marke Produktmarke Marke Nein Zeichenkette
gtin Globale Handelsnummer 9783161484100 Nein Zeichenkette
mpn Hersteller-Teilenummer CR2032 Nein Zeichenkette
Verfügbarkeit Produktverfügbarkeit Auf Lager Nein Zeichenkette
Demo anfordern
{ "name": "Product Name", "description": "Product Description", "url": "http://www.yousite.com/product/1", "image": "http://www.yousite.com/product/1.jpg", "sku": "SKU", "category": "Category", "price": 100, "currency": "USD", "old_price": 100, "brand": "Brand", "gtin": "9783161484100", "mpn": "CR2032", "availability": "In Stock" }
Demo zur Reaktion
{ "code": 0, "data": "Added", "msg": "success" }

Publisher-API

POST Verlag/Liste Verlagsliste
Schlüssel Titel Beispiel Erforderlich Typ
publisher_id Verlags-ID 9527 Nein int
Kanal-ID Kanal-ID 9527 Nein int
Status Status beigetreten Nein Zeichenkette
Demo anfordern
{ "publisher_id": 9527, "apply_status": "joined", "channel_id": 9527 }
Demo zur Reaktion
{ "code": 0, "msg": "success", "data": [ { "publisher_id": "109271", "publisher_name": "aaa_bai", "description": "", "channel_list": [ { "medium_id": "PB00040837", "channel_id": "40837", "status": "adopt", "title": "s1", "host": "http://s1.host", "word": ",2123,2413213", "userid": "109271", "c_id": "", "c_category_id": "6" } ], "keywords": [ "2123", "2413213", "s2", "s4" ], "category": [ "Food & Drink" ], "promotion_method": [] } ] }
POST Verlag/Wartung Herausgeber-Wartung
Schlüssel Titel Beispiel Erforderlich Typ
Benutzername Benutzer-ID (Entweder „userId“ oder „site_ids“ muss angegeben werden) 40828 Ja Zeichenkette
Site-IDs Site-IDs (Entweder userId oder site_ids ist erforderlich) 40828 Ja Zeichenkette
mail_id E-Mail-Adresse 40828 Nein Zeichenkette
automatisch genehmigen Automatisch genehmigen 1 Nein int
Status Status (angenommen/freigegeben/beendet/abgelehnt) übernehmen Ja Zeichenkette
Demo anfordern
{ "site_ids": "40828", "auto_approve": 1, "status": "adopt" }
Demo zur Reaktion
{ "code": 0, "data": null, "msg": "success" }
Publisher-API

Authentifizierung

Anfragen an die Publisher-API sollten an den folgenden Endpunkt gerichtet werden:

https://app.partnerboost.com/api.php?mod=medium&op={action}

HTTP-Anfragemethoden

  • POST application/x-www-form-urlencoded
  • POST application/json
  • HOLEN

Rückgabeformat

  • JSON (Standard)
  • XML

Erforderlicher Parameter

  • Token - Dein Kanal-API-Token (zu finden in deinem Publisher-Dashboard)
Hinweis

Jeder Kanal verfügt über einen eigenen API-Token. Du findest deine Token im Publisher-Dashboard unter „Tools“ > „API“.

Gängige Ergebniscodes

Code Beschreibung
0 Erfolg
1000 Der Verlag existiert nicht
1001 Ungültiges Token
1002 Anrufhäufigkeit zu hoch
1003 Erforderliche Parameter fehlen oder das Format ist falsch
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "brand_type": "DTC", "relationship": "Joined" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": [ { "brand_id": "66303", "mcid": "joes", "merchant_name": "Joe's Jeans", "brand_type": "DTC", "approval_type": "Auto", "offer_type": "CPS", "categories": "Apparel" } ] }

Transaktion

POST Transaktion Transaktionsliste abrufen

Rufen Sie detaillierte Transaktionen, den Provisionsstatus und vieles mehr ab.

Endpunkt
https://app.partnerboost.com/api.php?mod=medium&op=transaction

Erforderliche Parameter

Schlüssel Beschreibung Beispiel
Token Ihr Kanal-API-Token 79e33f8dac5a0be8579018760cff4cc227fb888d
Startdatum Beginn des Transaktionszeitraums. Entweder der Transaktionszeitraum oder der Validierungszeitraum ist obligatorisch. 01.01.2024
Enddatum Ende des Transaktionszeitraums 31.01.2024
Validierungsdatum (Beginn) Beginn des Validierungszeitraums. Entweder der Transaktionszeitraum oder der Validierungszeitraum ist obligatorisch. 01.01.2024
Gültigkeitsende Ende des Gültigkeitszeitraums 31.01.2024

Optionale Parameter

Schlüssel Beschreibung Beispiel
Typ Ausgabeformat: JSON (Standard) oder XML json
Bestellnummer Bestellnummer ORD123456
Status Status der Kommission: Ausstehend, Genehmigt, Abgelehnt, Normal, Alle Genehmigt
uid Ihre benutzerdefinierte Tracking-Variable tracking123
brand_id Markenidentität 66303
mcid Eindeutige Kennung für die Marke ulike0
Seite Inhaltsverzeichnis der aktuellen Seite 1
Grenze Anzahl der Transaktionen pro Seite (max. 2000) 100

Rückgabeparameter

Schlüssel Beschreibung
Kanal-ID Kanal-ID
Gesamtseitenzahl Gesamtseitenzahl
Gesamtanzahl Gesamtzahl der Verkaufstransaktionen
brand_id Markenidentität
mcid Eindeutige Kennung für die Marke
Händlername Markenname
Bestellnummer Bestellnummer
Bestellzeit Transaktionsdauer
Verkaufsbetrag Verkaufssumme
Verkaufsprovision Verkaufsprovision
Status Status der Kommission
uid Ihre benutzerdefinierte Tracking-Variable
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "begin_date": "2024-01-01", "end_date": "2024-01-31", "status": "Approved" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": { "channel_id": "500107", "total_page": "1", "total_trans": "1", "list": [ { "brand_id": "66303", "mcid": "joes", "merchant_name": "Joe's Jeans", "order_id": "ORD123456", "order_time": "1704067200", "sale_amount": "100.00", "sale_comm": "10.00", "status": "Approved", "uid": "tracking123" } ] } }

Auf „Melden“ klicken

POST Übertragung Klickbericht abrufen

Detailliertes Klickprotokoll abrufen.

Endpunkt
https://app.partnerboost.com/api.php?mod=medium&op=transfer

Erforderliche Parameter

Schlüssel Beschreibung Beispiel
Token Ihr Kanal-API-Token 79e33f8dac5a0be8579018760cff4cc227fb888d
Startdatum Startdatum und -zeit 01.01.2024 00:00:00
Enddatum Enddatum und -zeit 01.01.2024 01:00:00
Ratenbegrenzung

Der Zeitraum zwischen Start- und Enddatum darf eine Stunde nicht überschreiten. Maximal 10 Anfragen pro Minute.

Rückgabeparameter

Schlüssel Beschreibung
Kanal-ID Kanal-ID
Gesamtseitenzahl Gesamtseitenzahl
Gesamtanzahl der Artikel Gesamtzahl der Transaktionen, aufgeschlüsselt nach Posten
brand_id Markenidentität
mcid Eindeutige Kennung für die Marke
Händlername Markenname
uid Ihre benutzerdefinierte Tracking-Variable
Klickzeit Der Zeitpunkt, zu dem der Kunde auf Ihren Link klickt (UTC+8)
click_ref Eine eindeutige Transaktionsreferenz-ID
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "begin_date": "2024-01-01 00:00:00", "end_date": "2024-01-01 01:00:00" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": { "total_items": 1, "list": [ { "channel_id": "PB00039713", "click_time": "2022-11-01 14:49:17", "merchant_name": "24S Worldwide", "brand_id": "66303", "mcid": "24sevres", "click_ref": "pb_xx95", "uid": "" } ] } }

Kommission

POST merchant_commission API zur Provisionsvalidierung

Zeigt die genehmigte Provisionsaufschlüsselung nach Marken auf monatlicher Basis an.

Endpunkt
https://app.partnerboost.com/api.php?mod=settlement&op=merchant_commission

Erforderliche Parameter

Schlüssel Beschreibung Beispiel
Token Ihr Kanal-API-Token 79e33f8dac5a0be8579018760cff4cc227fb888d
Startdatum Startdatum 01.01.2024
Enddatum Enddatum 31.01.2024

Rückgabeparameter

Schlüssel Beschreibung
brand_id Markenidentität
mcid Eindeutige Kennung für die Marke
Verkaufsprovision Verkaufsprovision
Abrechnungsdatum Datum, an dem die Provision genehmigt und zur Auszahlung bereit ist
Anmerkung Zeitraum, in dem der Betrag generiert wird
Abrechnungs-ID Die eindeutige ID weist auf eine vom Händler genehmigte Provision hin
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "begin_date": "2024-01-01", "end_date": "2024-01-31" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": [ { "brand_id": "66303", "mcid": "joes", "sale_comm": "37.73", "settlement_date": "2018-04-27", "note": "2016-01-01 ~ 2016-01-31, joes Sales Commission", "settlement_id": "810b2ce13d1a3b640423" }, { "brand_id": "66304", "mcid": "finishline", "sale_comm": "17.45", "settlement_date": "2018-04-27", "note": "2016-01-01 ~ 2016-01-31, finishline Sales Commission", "settlement_id": "c32ff2f5ec5553bb0423" } ] }
POST commission_details API für Provisionsdetails

Verwenden Sie die Abrechnungs-ID, um die Provisionsaufschlüsselung nach Transaktionen pro Marke abzurufen.

Endpunkt
https://app.partnerboost.com/api.php?mod=settlement&op=commission_details

Erforderliche Parameter

Schlüssel Beschreibung Beispiel
Token Ihr Kanal-API-Token 79e33f8dac5a0be8579018760cff4cc227fb888d
Abrechnungs-ID Die eindeutige ID weist auf eine vom Händler genehmigte Provision hin 12345

Rückgabeparameter

Schlüssel Beschreibung
brand_id Markenidentität
mcid Eindeutige Kennung für die Marke
Händlername Markenname
Bestellnummer Bestellnummer
Bestellzeit Transaktionsdauer
Verkaufsbetrag Verkaufssumme
Verkaufsprovision Verkaufsprovision
Status Status der Kommission
uid Ihre benutzerdefinierte Tracking-Variable
prod_id Produkt-ID
Bestelleinheit Bestellmenge
Abrechnungs-ID Die eindeutige ID kennzeichnet eine genehmigte Provision
Validierungsdatum Datum der Transaktionsbestätigung
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "settlement_id": "12345" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": [ { "brand_id": "66306", "mcid": "katespade", "merchant_name": "Kate Spade", "order_id": "8720334", "order_time": "1502949706", "sale_amount": "69.00", "sale_comm": "5.52", "status": "Approved", "uid": "120802|00yl70cf45100529c704", "prod_id": "098687062527", "order_unit": "1", "settlement_id": "804a15b9ac6f5fa11113", "validation_date": "2021-04-05", "note": "order returned" } ] }

Zahlung

POST Zahlungsübersicht Zahlungsübersicht-API

Zeigt Ihren Zahlungsverlauf an.

Endpunkt
https://app.partnerboost.com/api.php?mod=medium&op=payment_summary

Erforderliche Parameter

Schlüssel Beschreibung Beispiel
Token Ihr Kanal-API-Token 79e33f8dac5a0be8579018760cff4cc227fb888d
Zahlungs-ID Zahlungs-ID (payment_id oder paid_date_begin und paid_date_end sind Pflichtangaben) 12345
Zahlungsbeginn Beginn des Zahlungszeitraums (JJJJ-MM-TT) 01.01.2024
Zahlungsdatum (Ende) Zahlungsdatum (JJJJ-MM-TT) 31.01.2024

Rückgabeparameter

Schlüssel Beschreibung
Zahlungs-ID Die Zahlungs-ID, die Sie unter „Zahlungsverlauf“ finden
Antragsdatum Datum, an dem die Zahlung angelegt wurde
Zahlungsdatum Datum, an dem die Zahlung als beglichen markiert wird
Zahlungsart Zahlungsart
Zahlungsdetails Kontoinformationen
Rechnung Rechnungsdaten
Betrag Zahlungsbetrag
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "paid_date_begin": "2024-01-01", "paid_date_end": "2024-01-31" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": { "total_items": "5", "list": [ { "payment_id": "3949", "request_date": "2023-10-10", "paid_date": "2023-10-10", "invoice": "", "amount": "$20.00", "payment_details": "500107", "payment_type": "Bank Wire" }, { "payment_id": "3952", "request_date": "2023-10-10", "paid_date": "2023-10-10", "invoice": "", "amount": "$30.00", "payment_details": "500107", "payment_type": "Bank Wire" } ], "page": 100, "limit": 1 } }
POST payment_detail Zahlungsdetails-API

Zeigt Ihre detaillierte Zahlungsübersicht an.

Endpunkt
https://app.partnerboost.com/api.php?mod=medium&op=payment_detail

Erforderliche Parameter

Schlüssel Beschreibung Beispiel
Token Ihr Kanal-API-Token 79e33f8dac5a0be8579018760cff4cc227fb888d
Zahlungs-ID Zahlungs-ID (payment_id oder paid_date_begin und paid_date_end sind Pflichtangaben) 12345
Zahlungsbeginn Beginn des Zahlungszeitraums (JJJJ-MM-TT) 01.01.2024
Zahlungsdatum (Ende) Zahlungsdatum (JJJJ-MM-TT) 31.01.2024

Rückgabeparameter

Schlüssel Beschreibung
brand_id Markenidentität
mcid Eindeutige Kennung für die Marke
Betrag Provisionsbetrag oder Bonusbetrag
Validierungsdatum Datum der Genehmigung der Provision
Typ Die Art der Vergütung kann eine Provision oder ein Bonus sein
Anmerkung Zeitraum, in dem der Betrag generiert wird
Abrechnungs-ID Die eindeutige ID kennzeichnet eine genehmigte Provision
Händlername Name des Händlers
Zahlungs-ID Die Zahlungs-ID, die Sie unter „Zahlungsverlauf“ finden
Zahlungsdatum Datum, an dem die Zahlung als beglichen markiert wird
sign_id Eindeutige Kennung speichern
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "payment_id": "3949" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": [ { "brand_id": "66306", "mcid": "katespade", "merchant_name": "Kate Spade", "amount": "20.00", "validation_date": "2023-10-10", "type": "commission", "note": "2023-09-01 ~ 2023-09-30", "settlement_id": "804a15b9ac6f5fa11113", "payment_id": "3949", "paid_date": "2023-10-10", "sign_id": "12345" } ] }

Monetarisierung

POST monetization_api Monetarisierungs-API

Überprüfen Sie den Status der Markendaten und rufen Sie Kampagnenlinks ab, um Ihren Traffic zu monetarisieren.

Endpunkt
https://app.partnerboost.com/api.php?mod=medium&op=monetization_api

Erforderliche Parameter

Schlüssel Beschreibung Beispiel
Token Ihr Kanal-API-Token 79e33f8dac5a0be8579018760cff4cc227fb888d

Optionale Parameter

Schlüssel Beschreibung Beispiel
Typ Ausgabeformat: JSON (Standard) oder XML json
Markentyp Markentypen: TikTok, DTC, Amazon, Walmart, Indirekt DTC
Genehmigungsart Nach Genehmigungsart filtern: Automatisch, Manuell Auto
Angebotsart Nach Preismodell der Marke filtern: CPS, CPA, CPC, CPL, CPX, CPM CPS
Beziehung Nach aktuellem Status der Markenbeziehung filtern: Angenommen, Ausstehend, Abgelehnt, Keine Beziehung Mitglied seit
Kategorien Nach Markenkategorien filtern Bekleidung
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "brand_type": "DTC", "relationship": "Joined" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": [ { "brand_id": "66303", "mcid": "joes", "merchant_name": "Joe's Jeans", "brand_type": "DTC", "approval_type": "Auto", "offer_type": "CPS", "categories": "Apparel" } ] }

Gutschein

POST coupon_list Gutschein-API

Holen Sie sich aktuelle Gutscheine und Angebote von verschiedenen Marken.

Endpunkt
https://app.partnerboost.com/api.php?mod=coupon&op=coupon_list

Erforderliche Parameter

Schlüssel Beschreibung Beispiel
Token Gutschein-Token 79e33f8dac5a0be8579018760cff4cc227fb888d

Optionale Parameter

Schlüssel Beschreibung Beispiel
Markentyp 3 Vertriebskanäle: D2C, Amazon, indirekter Vertrieb D2C
brand_id Markenidentität 66303
mcid Eindeutige Kennung für die Marke ulike0
Spur Tracking-Code im Tracking-Link Track 123
Typ Es gibt zwei Arten von Gutscheinen: Gutscheine oder Angebote Gutschein
Land Die Länder, in denen der Gutschein eingelöst werden kann US
Herkunftskategorie Kategorie des Händlers, der den Gutschein anbietet Bekleidung
Ebene Stufe 1–4, wobei Stufe 1 die höchste ist 1
Sprache Sprache des Gutscheins de
pro Seite Anzahl der Einträge pro Seite (Standard: 50, maximal 2000) 100
Seite Aktueller Seitenindex (beginnt bei 1) 1
Erstellt am Erstellungsdatum (JJJJ-MM-TT) 01.01.2024
aktualisiert am Aktualisierungsdatum (JJJJ-MM-TT) 01.01.2024

Rückgabeparameter

Schlüssel Beschreibung
creative_id Kreative ID
brand_id Markenidentität
Einschränkungen Einschränkungen für Gutscheine
Stichwörter Stichwörter
Bild Bild des Gutscheins
Miniaturansicht Miniaturbild
smart_url Intelligente URL
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "brand_id": "66303", "per_page": 100, "page": 1 }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": [ { "creative_id": "12345", "brand_id": "66303", "restrictions": "Minimum purchase $50", "keywords": "fashion, apparel", "image": "https://example.com/coupon.jpg", "thumbnail": "https://example.com/thumb.jpg", "smart_url": "https://partnerboost.com/smart/abc123" } ] }

Datenfeed

POST Liste Datafeed-Liste-API

Produktdaten von den Marken abrufen.

Endpunkt
https://app.partnerboost.com/api.php?mod=datafeed&op=list

Erforderliche Parameter

Schlüssel Beschreibung Beispiel
Token Ihr Kanal-API-Token 79e33f8dac5a0be8579018760cff4cc227fb888d

Optionale Parameter

Schlüssel Beschreibung Beispiel
Typ Ausgabeformat: JSON (Standard) oder XML json
Markentyp Markentypen: TikTok, DTC, Walmart DTC
brand_id Markenidentität 66303
mcid Eindeutige Kennung für die Marke ulike0
Seite Aktuelle Seite – Inhaltsverzeichnis 1
Grenze Anzahl der Produkte pro Seite (max. 100) 50
Stichwörter Stichwörter Hemd
Preisspanne Eine der folgenden Optionen: „0–75“, „75–150“, „150–300“, „300–500“, „500–1000“, „1000+“ 75–150
Mindestrabatt Einer von 75, 50, 25, 10 25

Rückgabeparameter

Schlüssel Beschreibung
Name Produktname
Beschreibung Produktbeschreibung
brand_id Markenidentität
mcid Eindeutige Kennung für die Marke
Händlername Der Name des Händlers, der dieses Produkt verkauft
URL Die ursprüngliche Produkt-URL
Bild Der Link zum Produktbild
Artikelnummer Artikelnummer des Produkts
Kategorie Produktkategorie
Preis Aktueller Preis des Produkts
Tracking-URL Affiliate-Tracking-URL
tracking_url_short Kurze Affiliate-Tracking-URL
tracking_url_smart Intelligente Affiliate-Tracking-URL
aktualisiert am Zeitpunkt der letzten Aktualisierung
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "brand_type": "DTC", "limit": 50, "page": 1 }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "Success" }, "data": [ { "name": "Classic Cotton T-Shirt", "description": "Comfortable cotton t-shirt", "brand_id": "66303", "mcid": "joes", "merchant_name": "Joe's Jeans", "url": "https://example.com/product/123", "image": "https://example.com/images/product.jpg", "sku": "SKU12345", "category": "Apparel", "price": "29.99", "tracking_url": "https://partnerboost.com/track/abc123", "tracking_url_short": "https://pb.co/abc", "tracking_url_smart": "https://partnerboost.com/smart/abc123", "updated_at": "2024-01-15 10:30:00" } ] }

Amazon

Basis-URL der Amazon Publisher API: https://amazon-service.partnerboost.com/amazon_api. Alle folgenden Endpunkte verwenden BEITRAG mit JSON-Inhalt application/json.

POST get_fba_products API zum Abrufen von Produkten

Amazon-Produkte nach Kriterien filtern und suchen (Seitenanzahl, Land, Marke, ASINs, Sonderangebote usw.).

Endpunkt
https://amazon-service.partnerboost.com/amazon_api/api/datafeed/get_fba_products
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "page_size": 20, "page": 1, "default_filter": 0, "country_code": "", "brand_id": null, "sort": "", "asins": "", "relationship": 1, "is_original_currency": 0, "has_promo_code": 0, "has_acc": 0, "filter_sexual_wellness": 0 }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "success" }, "data": { "list": [ { "product_id": "007d030d256e3e35774d65822f89c778", "product_name": "Example Product", "asin": "B0CQT26VCW", "commission": "10%", "category": "Appliances", "url": "https://www.amazon.com/dp/B0CQT26VCW", "brand_id": "90863", "country_code": "US" } ], "has_more": true } }
POST get_fba_products_link API zum Abrufen des Produktlinks (Produkt-ID)

Erstellen Sie Tracking-Links anhand der Produkt-IDs, die von der „Get Products“-API zurückgegeben werden.

Endpunkt
https://amazon-service.partnerboost.com/amazon_api/api/datafeed/get_fba_products_link
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "product_ids": "007d030d256e3e35774d65822f89c778", "uid": "123" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "success" }, "data": [ { "product_id": "007d030d256e3e35774d65822f89c778", "link": "https://www.amazon.com/dp/B0CQT26VCW?maas=...", "link_id": "5a19kG_aIdGFJrujZS3rjehf1RoROk2O8_bveeZQSggsULwwlmW2JT7vMOckEw0A_a1I_bNTErmMiVHobJT9S53Tvx7WFDtBnEGLhIcLwA8_c" } ], "error_list": [ { "product_id": "111", "message": "Product not found or no relationship" } ] }
POST get_amazon_link_by_asin API zum Abrufen von Produktlinks (ASIN)

Erstellen Sie Produkt-Tracking-Links anhand von ASINs und Marktplätzen.

Endpunkt
https://amazon-service.partnerboost.com/amazon_api/api/datafeed/get_amazon_link_by_asin
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "asins": "B0CQT26VCW", "country_code": "US", "uid": "", "return_partnerboost_link": 0 }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "success" }, "data": [ { "asin": "B0CQT26VCW", "link": "https://www.amazon.com/dp/B0CQT26VCW?maas=...", "partnerboost_link": "", "link_id": "2ff9hHMP1uL7XgpmaCERzIlQ1gFQhwaNuCOb_bPEa6NfGIuU7Bbf9zjFW7tyPCyNUCPDH_bvW16vdcA8fMoxkYd7xpkgc9UhIkEXU_c" } ], "error_list": [ { "asin": "B0CQ2JMS731", "country_code": "US", "message": "Product not found or no relationship" } ] }
POST get_amazon_joined_brands API für Partnermarken abrufen

Führen Sie die Amazon-Marken auf, mit denen Sie zusammenarbeiten (mit Seitenangabe).

Endpunkt
https://amazon-service.partnerboost.com/amazon_api/api/datafeed/get_amazon_joined_brands
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "bids": "90863", "page_size": 20, "page": 1 }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "success" }, "data": { "list": [ { "bid": "90863", "brand_name": "Midea_US", "support_storefront_link": "yes" } ], "hasMore": false } }
POST get_fba_brand_link API zum Abrufen des Storefront-Links

Erstellen Sie Tracking-Links für den Shop anhand von Marken-IDs (Geboten).

Endpunkt
https://amazon-service.partnerboost.com/amazon_api/api/datafeed/get_fba_brand_link
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "bids": "90863", "uid": "zxf" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "success" }, "data": [ { "bid": "90863", "brand_name": "Midea_US", "storefront_link": "https://www.amazon.com/stores/page/...", "storefront_short_link": "https://pboost.me/JqLDkvht?uid=zxf", "link_id": "2356UTnKtRt_atVWUJCB5mBgYP6bhTuU91YCLgLd4zZQclplXKUty8YgXL5jjRlmjAbAnmAIFPb8q8JDGvvng99S903nog6k_c" } ], "error_list": [ { "bid": "77", "brand_name": "test bid", "message": "Bid not found or no relationship." } ] }
POST get_amazon_link_status Link-Status-API

Überprüfen Sie, ob Werbelinks weiterhin anhand der Link-ID nachverfolgt werden können.

Endpunkt
https://amazon-service.partnerboost.com/amazon_api/api/datafeed/get_amazon_link_status
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "link_ids": "2ff9hHMP1uL7XgpmaCERzIlQ1gFQhwaNuCOb_bPEa6NfGIuU7Bbf9zjFW7tyPCyNUCPDH_bvW16vdcA8fMoxkYd7xpkgc9UhIkEXU_c" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "success" }, "data": [ { "link_id": "2ff9hHMP1uL7XgpmaCERzIlQ1gFQhwaNuCOb_bPEa6NfGIuU7Bbf9zjFW7tyPCyNUCPDH_bvW16vdcA8fMoxkYd7xpkgc9UhIkEXU_c", "active": true, "asin": "B0CQT26VCW", "brand_id": 90863, "link": "https://www.amazon.com/dp/B0CQT26VCW?maas=...", "country": "US", "type": "product", "uid": "" } ] }
POST get_amazon_report Amazon-Bericht-API

Bestellkonversions-/Leistungsbericht für Tracking-Links (Datumsbereich, Marktplatz, ASINs, Anzeigengruppen, Bestell-IDs).

Endpunkt
https://amazon-service.partnerboost.com/amazon_api/api/datafeed/get_amazon_report
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "page_size": 100, "page": 1, "start_date": "20241201", "end_date": "20241202", "marketplace": "", "asins": "", "adGroupIds": "", "order_ids": "" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "success" }, "data": { "list": [ { "asin": "B0C6DHK68Q", "date": "20241202", "marketplace": "US", "currency": "USD", "estCommission": 0, "sales": 0, "quantity": 0, "conversionRate": "0.00%", "clicks": 4, "addToCarts": 0, "detailPageViews": 2, "productConversionType": "Promoted", "link": "https://www.amazon.com/dp/...", "uid": "sherry", "adGroupId": "a6e3PBLq_ayRy2ZHjkvNvuSc3HqaLxHWh7tZO1jvSwkhTmyEsUJtgQga1fQOAqndyCMTs_aBKOVU6OLQmWZeLPfEGF9URtJkGJAQEXdWdQjhj5U2Jv7PmcjWf1Wgw6UYyiGHT3Wvz_c", "order_id": "C1TIP-PJ09161555" } ] } }
POST get_latest_associates_products API für die ASIN-Liste der Partner

ASINs des Amazon-Partnerprogramms filtern und suchen (Region, Seiten).

Endpunkt
https://amazon-service.partnerboost.com/amazon_api/api/datafeed/get_latest_associates_products
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "page_size": 200, "page": 1, "filter_sexual_wellness": 0, "region": "us" }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "success" }, "data": { "list": [ { "brand_name": "cololight", "asin": "B0DT9Q7CT2", "commission": 0.15, "region": "us", "net_commission": 0.03, "start_date": "2025-10-09T10:00:00-07:00", "end_date": "2025-10-19T11:00:00-07:00", "acc_commission_rate": 0.12, "acc_start_date": "2025-08-01", "acc_end_date": "2025-12-31", "acc_budget": "10000.00", "acc_spend": "518.80", "acc_currency": "USD" } ] } }
POST get_latest_acc_products Amazon Creator Connection ASIN-Liste-API

ASINs von Amazon Creator Connection (ACC)-Kampagnen filtern und suchen.

Endpunkt
https://amazon-service.partnerboost.com/amazon_api/api/datafeed/get_latest_acc_products
Demo anfordern
{ "token": "79e33f8dac5a0be8579018760cff4cc227fb888d", "page_size": 200, "page": 1 }
Demo zur Reaktion
{ "status": { "code": 0, "msg": "success" }, "data": { "list": [ { "bid": 73237, "brand_name": "cololight", "asin": "B0CXPD7ZN9", "commission": "0.15", "start_date": "2026-03-18T00:57:18-07:00", "end_date": "2026-04-01T00:59:59-07:00", "acc_campaign_id": "amzn1.campaign.3ABT368W9RO04", "acc_commission_rate": "0.12", "acc_start_date": "2026-03-10", "acc_end_date": "2026-04-09", "acc_budget": "5000.00", "acc_spend": "0.00", "acc_currency": "USD" } ] } }
Der Branchenführer für Partnerschaftsmanagementlösungen, der Marken und Vermarktern mit Hilfe von End-to-End-Softwarelösungen und -Dienstleistungen zu skalierbarem Wachstum verhilft.
„Amazon“ und alle damit verbundenen Marken sind Marken von Amazon.com, Inc. oder deren verbundenen Unternehmen.