From 1f20a6c8207e7b839ffd56ae1786d9b58a8fe17e Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 12 Aug 2026 21:29:19 +0000
Subject: [PATCH] feat: add iHerb providers (Partnerize, Impact, Apify)

Add three new providers for iHerb affiliate and scraper APIs:
- iherb_partnerize: 8 operations (campaigns, commissions, conversions,
  product feeds, tracking links, click/performance reports)
- iherb_impact: 8 operations (campaigns, actions, catalogs, tracking
  links, promo codes)
- iherb_apify: 7 operations (product search, details, reviews, price
  monitoring, run management)

Total: 24 providers, 301 operations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0176k7T6i3B197hY6TqPdWqj
---
 README.md                    |   7 +-
 crates/hub-auth/src/store.rs |  42 +++++
 specs/iherb_apify.json       | 242 ++++++++++++++++++++++++++++
 specs/iherb_impact.json      | 301 +++++++++++++++++++++++++++++++++++
 specs/iherb_partnerize.json  | 249 +++++++++++++++++++++++++++++
 5 files changed, 839 insertions(+), 2 deletions(-)
 create mode 100644 specs/iherb_apify.json
 create mode 100644 specs/iherb_impact.json
 create mode 100644 specs/iherb_partnerize.json

diff --git a/README.md b/README.md
index c090a57..981b4d2 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # Omni Connector Hub
 
 One hub for AI providers, email, hosting panels, VPS clouds, chat, GitHub, and
-server operations — 21 providers, 278 operations, behind one type-safe
+server operations — 24 providers, 301 operations, behind one type-safe
 interface with a hash-chained audit ledger.
 
 ## Providers
@@ -18,6 +18,9 @@ interface with a hash-chained audit ledger.
 | `github` | 25 | 2 | `GITHUB_TOKEN` | hand-written |
 | `gmail` | 79 | 15 | `GOOGLE_CLIENT_ID/SECRET` + refresh tokens | Google Discovery |
 | `hetzner` | 72 | 11 | `HETZNER_API_TOKEN` | OpenAPI 3.0.3 |
+| `iherb_apify` | 7 | 0 | `IHERB_APIFY_TOKEN` | hand-written |
+| `iherb_impact` | 8 | 0 | `IHERB_IMPACT_ACCOUNT_SID` + `IHERB_IMPACT_AUTH_TOKEN` | hand-written |
+| `iherb_partnerize` | 8 | 0 | `IHERB_PARTNERIZE_APP_KEY` + `IHERB_PARTNERIZE_USER_KEY` | hand-written |
 | `kimi` | 2 | 0 | `MOONSHOT_API_KEY` | hand-written |
 | `linode` | 9 | 1 | `LINODE_API_TOKEN` | hand-written |
 | `oneprovider` | 6 | 0 | `ONEPROVIDER_API_KEY` | hand-written |
@@ -32,7 +35,7 @@ interface with a hash-chained audit ledger.
 | `whm` | 9 | 1 | `WHM_HOST` + root token | hand-written |
 | `whmcs` | 9 | 0 | `WHMCS_URL` + API identifier/secret | hand-written |
 
-**Total: 278 operations (32 destructive)**
+**Total: 301 operations (32 destructive)**
 
 ## Quick start
 
diff --git a/crates/hub-auth/src/store.rs b/crates/hub-auth/src/store.rs
index 461fa0d..0593910 100644
--- a/crates/hub-auth/src/store.rs
+++ b/crates/hub-auth/src/store.rs
@@ -572,6 +572,48 @@ impl AuthStore {
             });
         }
 
+        // iHerb Partnerize (affiliate network)
+        if let (Ok(app_key), Ok(user_key)) = (
+            std::env::var("IHERB_PARTNERIZE_APP_KEY"),
+            std::env::var("IHERB_PARTNERIZE_USER_KEY"),
+        ) {
+            store.add(Credential {
+                provider: "iherb_partnerize".into(),
+                account_id: "default".into(),
+                base_url: Some("https://api.partnerize.com/v3".into()),
+                auth: AuthMethod::Basic {
+                    username: app_key,
+                    password: user_key,
+                },
+            });
+        }
+
+        // iHerb Impact (affiliate network)
+        if let (Ok(account_sid), Ok(auth_token)) = (
+            std::env::var("IHERB_IMPACT_ACCOUNT_SID"),
+            std::env::var("IHERB_IMPACT_AUTH_TOKEN"),
+        ) {
+            store.add(Credential {
+                provider: "iherb_impact".into(),
+                account_id: "default".into(),
+                base_url: Some("https://api.impact.com".into()),
+                auth: AuthMethod::Basic {
+                    username: account_sid,
+                    password: auth_token,
+                },
+            });
+        }
+
+        // iHerb Apify scraper
+        if let Ok(token) = std::env::var("IHERB_APIFY_TOKEN") {
+            store.add(Credential {
+                provider: "iherb_apify".into(),
+                account_id: "default".into(),
+                base_url: Some("https://api.apify.com/v2".into()),
+                auth: AuthMethod::Bearer { token },
+            });
+        }
+
         // SMTP email accounts: EMAIL_SMTP_HOST, EMAIL_SMTP_PORT, EMAIL_SMTP_USER,
         // EMAIL_SMTP_PASS, EMAIL_SMTP_FROM, EMAIL_SMTP_TLS for default account.
         // EMAIL_SMTP_HOST_<LABEL> etc. for named accounts.
diff --git a/specs/iherb_apify.json b/specs/iherb_apify.json
new file mode 100644
index 0000000..9547e82
--- /dev/null
+++ b/specs/iherb_apify.json
@@ -0,0 +1,242 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "iHerb Apify Scraper API",
+    "version": "1.0.0",
+    "description": "Apify actor API for the iHerb scraper. Provides product search, product details, reviews, and price monitoring via the Apify platform."
+  },
+  "servers": [
+    { "url": "https://api.apify.com/v2" }
+  ],
+  "security": [
+    { "BearerAuth": [] }
+  ],
+  "components": {
+    "securitySchemes": {
+      "BearerAuth": {
+        "type": "http",
+        "scheme": "bearer",
+        "description": "Apify API token as Bearer token"
+      }
+    }
+  },
+  "paths": {
+    "/acts/vaunted~iherb-scraper/runs?action=search": {
+      "post": {
+        "operationId": "run_search",
+        "summary": "Search iHerb products",
+        "description": "Starts an Apify actor run to search iHerb products by keyword. Returns a run object with an ID to poll for results.",
+        "tags": ["scraper"],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["search"],
+                "properties": {
+                  "search": {
+                    "type": "string",
+                    "description": "Search keyword or phrase (e.g. 'vitamin D', 'omega 3')"
+                  },
+                  "maxItems": {
+                    "type": "integer",
+                    "default": 50,
+                    "description": "Maximum number of products to return"
+                  },
+                  "sort": {
+                    "type": "string",
+                    "enum": ["relevance", "best_selling", "price_asc", "price_desc", "rating", "newest"],
+                    "description": "Sort order for search results"
+                  },
+                  "country": {
+                    "type": "string",
+                    "default": "US",
+                    "description": "Country code for localized pricing and availability"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/acts/vaunted~iherb-scraper/runs?action=details": {
+      "post": {
+        "operationId": "run_product_details",
+        "summary": "Get iHerb product details",
+        "description": "Starts an Apify actor run to scrape full product information from iHerb product URLs.",
+        "tags": ["scraper"],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["urls"],
+                "properties": {
+                  "urls": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "List of iHerb product URLs to scrape"
+                  },
+                  "country": {
+                    "type": "string",
+                    "default": "US",
+                    "description": "Country code for localized pricing"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/acts/vaunted~iherb-scraper/runs?action=reviews": {
+      "post": {
+        "operationId": "run_reviews",
+        "summary": "Scrape iHerb product reviews",
+        "description": "Starts an Apify actor run to collect product reviews from iHerb, including ratings, text, and reviewer info.",
+        "tags": ["scraper"],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["productUrl"],
+                "properties": {
+                  "productUrl": {
+                    "type": "string",
+                    "description": "iHerb product URL to scrape reviews from"
+                  },
+                  "maxReviews": {
+                    "type": "integer",
+                    "default": 100,
+                    "description": "Maximum number of reviews to collect"
+                  },
+                  "sort": {
+                    "type": "string",
+                    "enum": ["newest", "oldest", "highest_rating", "lowest_rating", "most_helpful"],
+                    "description": "Sort order for reviews"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/acts/vaunted~iherb-scraper/runs?action=price_monitor": {
+      "post": {
+        "operationId": "run_price_monitor",
+        "summary": "Monitor iHerb product prices",
+        "description": "Starts an Apify actor run to track and record current prices for specified iHerb products.",
+        "tags": ["scraper"],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["urls"],
+                "properties": {
+                  "urls": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "List of iHerb product URLs to monitor prices for"
+                  },
+                  "country": {
+                    "type": "string",
+                    "default": "US",
+                    "description": "Country code for localized pricing"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/acts/vaunted~iherb-scraper/runs/{run_id}": {
+      "get": {
+        "operationId": "get_run",
+        "summary": "Get scraper run status",
+        "description": "Returns the status and metadata of a specific actor run, including whether it has finished and the default dataset ID for results.",
+        "tags": ["runs"],
+        "parameters": [
+          {
+            "name": "run_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Actor run ID"
+          }
+        ]
+      }
+    },
+    "/datasets/{dataset_id}/items": {
+      "get": {
+        "operationId": "get_dataset_items",
+        "summary": "Get scraper run results",
+        "description": "Returns the scraped data items from a completed actor run's dataset. Use the dataset ID from the run status response.",
+        "tags": ["runs"],
+        "parameters": [
+          {
+            "name": "dataset_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Dataset ID from the actor run"
+          },
+          {
+            "name": "format",
+            "in": "query",
+            "schema": { "type": "string", "enum": ["json", "csv", "xlsx"], "default": "json" },
+            "description": "Output format for the dataset items"
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": { "type": "integer" },
+            "description": "Maximum number of items to return"
+          },
+          {
+            "name": "offset",
+            "in": "query",
+            "schema": { "type": "integer", "default": 0 },
+            "description": "Number of items to skip"
+          }
+        ]
+      }
+    },
+    "/acts/vaunted~iherb-scraper/runs": {
+      "get": {
+        "operationId": "list_runs",
+        "summary": "List past scraper runs",
+        "description": "Returns a list of past actor runs with their statuses, start times, and dataset IDs.",
+        "tags": ["runs"],
+        "parameters": [
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": { "type": "integer", "default": 25 },
+            "description": "Maximum number of runs to return"
+          },
+          {
+            "name": "offset",
+            "in": "query",
+            "schema": { "type": "integer", "default": 0 },
+            "description": "Number of runs to skip"
+          },
+          {
+            "name": "status",
+            "in": "query",
+            "schema": { "type": "string", "enum": ["READY", "RUNNING", "SUCCEEDED", "FAILED", "TIMED-OUT", "ABORTED"] },
+            "description": "Filter runs by status"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specs/iherb_impact.json b/specs/iherb_impact.json
new file mode 100644
index 0000000..1e96d8c
--- /dev/null
+++ b/specs/iherb_impact.json
@@ -0,0 +1,301 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "iHerb Impact Affiliate API",
+    "version": "1.0.0",
+    "description": "Impact affiliate network API for iHerb. Provides access to campaigns, actions (conversions), product catalogs, tracking links, and promotional codes."
+  },
+  "servers": [
+    { "url": "https://api.impact.com" }
+  ],
+  "security": [
+    { "BasicAuth": [] }
+  ],
+  "components": {
+    "securitySchemes": {
+      "BasicAuth": {
+        "type": "http",
+        "scheme": "basic",
+        "description": "HTTP Basic auth using account_sid as username and auth_token as password"
+      }
+    }
+  },
+  "paths": {
+    "/{account_sid}/Campaigns": {
+      "get": {
+        "operationId": "list_campaigns",
+        "summary": "List available campaigns",
+        "description": "Returns all campaigns available to the media partner, including iHerb affiliate programs with their status, commission rates, and terms.",
+        "tags": ["campaigns"],
+        "parameters": [
+          {
+            "name": "account_sid",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Your Impact account SID"
+          },
+          {
+            "name": "Status",
+            "in": "query",
+            "schema": { "type": "string", "enum": ["Active", "Inactive", "Pending"] },
+            "description": "Filter campaigns by status"
+          },
+          {
+            "name": "PageSize",
+            "in": "query",
+            "schema": { "type": "integer", "default": 25 },
+            "description": "Number of results per page"
+          },
+          {
+            "name": "Page",
+            "in": "query",
+            "schema": { "type": "integer", "default": 0 },
+            "description": "Page number (zero-indexed)"
+          }
+        ]
+      }
+    },
+    "/{account_sid}/Campaigns/{campaign_id}": {
+      "get": {
+        "operationId": "get_campaign",
+        "summary": "Get campaign details",
+        "description": "Returns detailed information about a specific campaign including contract terms, commission structure, and advertiser details.",
+        "tags": ["campaigns"],
+        "parameters": [
+          {
+            "name": "account_sid",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Your Impact account SID"
+          },
+          {
+            "name": "campaign_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Campaign ID"
+          }
+        ]
+      }
+    },
+    "/{account_sid}/Actions": {
+      "get": {
+        "operationId": "list_actions",
+        "summary": "List conversion actions",
+        "description": "Returns tracked conversions (actions) showing sales, order values, commissions, and status for iHerb referrals.",
+        "tags": ["actions"],
+        "parameters": [
+          {
+            "name": "account_sid",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Your Impact account SID"
+          },
+          {
+            "name": "StartDate",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Filter actions from this date (YYYY-MM-DD)"
+          },
+          {
+            "name": "EndDate",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Filter actions until this date (YYYY-MM-DD)"
+          },
+          {
+            "name": "CampaignId",
+            "in": "query",
+            "schema": { "type": "string" },
+            "description": "Filter by campaign ID"
+          },
+          {
+            "name": "Status",
+            "in": "query",
+            "schema": { "type": "string", "enum": ["Approved", "Pending", "Reversed"] },
+            "description": "Filter by action status"
+          },
+          {
+            "name": "PageSize",
+            "in": "query",
+            "schema": { "type": "integer", "default": 25 },
+            "description": "Number of results per page"
+          }
+        ]
+      }
+    },
+    "/{account_sid}/Actions/{action_id}": {
+      "get": {
+        "operationId": "get_action",
+        "summary": "Get action details",
+        "description": "Returns full details for a specific conversion action including line items, customer info, and payout details.",
+        "tags": ["actions"],
+        "parameters": [
+          {
+            "name": "account_sid",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Your Impact account SID"
+          },
+          {
+            "name": "action_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Action ID"
+          }
+        ]
+      }
+    },
+    "/{account_sid}/Catalogs": {
+      "get": {
+        "operationId": "list_catalogs",
+        "summary": "List product catalogs",
+        "description": "Returns available product catalogs from iHerb, listing catalog names, item counts, and last update timestamps.",
+        "tags": ["catalogs"],
+        "parameters": [
+          {
+            "name": "account_sid",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Your Impact account SID"
+          },
+          {
+            "name": "CampaignId",
+            "in": "query",
+            "schema": { "type": "string" },
+            "description": "Filter catalogs by campaign ID"
+          }
+        ]
+      }
+    },
+    "/{account_sid}/Catalogs/{catalog_id}/Items": {
+      "get": {
+        "operationId": "get_catalog_items",
+        "summary": "Get catalog product items",
+        "description": "Returns product items from a specific catalog including product names, prices, categories, images, and affiliate links.",
+        "tags": ["catalogs"],
+        "parameters": [
+          {
+            "name": "account_sid",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Your Impact account SID"
+          },
+          {
+            "name": "catalog_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Catalog ID"
+          },
+          {
+            "name": "Query",
+            "in": "query",
+            "schema": { "type": "string" },
+            "description": "Search query to filter products"
+          },
+          {
+            "name": "PageSize",
+            "in": "query",
+            "schema": { "type": "integer", "default": 25 },
+            "description": "Number of items per page"
+          },
+          {
+            "name": "Page",
+            "in": "query",
+            "schema": { "type": "integer", "default": 0 },
+            "description": "Page number (zero-indexed)"
+          }
+        ]
+      }
+    },
+    "/{account_sid}/UniqueUrls": {
+      "post": {
+        "operationId": "create_tracking_link",
+        "summary": "Generate affiliate tracking URL",
+        "description": "Creates a unique affiliate tracking URL for a specific iHerb product or page, with optional sub-tracking IDs.",
+        "tags": ["tracking"],
+        "parameters": [
+          {
+            "name": "account_sid",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Your Impact account SID"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["CampaignId", "Url"],
+                "properties": {
+                  "CampaignId": {
+                    "type": "string",
+                    "description": "Campaign ID for the tracking link"
+                  },
+                  "Url": {
+                    "type": "string",
+                    "description": "The iHerb destination URL"
+                  },
+                  "SubId1": {
+                    "type": "string",
+                    "description": "Optional sub-tracking ID 1"
+                  },
+                  "SubId2": {
+                    "type": "string",
+                    "description": "Optional sub-tracking ID 2"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/{account_sid}/PromoCodes": {
+      "get": {
+        "operationId": "list_promo_codes",
+        "summary": "List promotional codes",
+        "description": "Returns available promotional codes and coupons for iHerb campaigns, including discount details and validity periods.",
+        "tags": ["promotions"],
+        "parameters": [
+          {
+            "name": "account_sid",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Your Impact account SID"
+          },
+          {
+            "name": "CampaignId",
+            "in": "query",
+            "schema": { "type": "string" },
+            "description": "Filter promo codes by campaign ID"
+          },
+          {
+            "name": "Status",
+            "in": "query",
+            "schema": { "type": "string", "enum": ["Active", "Expired", "Upcoming"] },
+            "description": "Filter by promo code status"
+          },
+          {
+            "name": "PageSize",
+            "in": "query",
+            "schema": { "type": "integer", "default": 25 },
+            "description": "Number of results per page"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specs/iherb_partnerize.json b/specs/iherb_partnerize.json
new file mode 100644
index 0000000..2f57a9e
--- /dev/null
+++ b/specs/iherb_partnerize.json
@@ -0,0 +1,249 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "iHerb Partnerize Affiliate API",
+    "version": "1.0.0",
+    "description": "Partnerize affiliate network API for iHerb. Provides access to campaigns, commissions, conversions, product feeds, tracking links, click reports, and performance stats."
+  },
+  "servers": [
+    { "url": "https://api.partnerize.com/v3" }
+  ],
+  "security": [
+    { "BasicAuth": [] }
+  ],
+  "components": {
+    "securitySchemes": {
+      "BasicAuth": {
+        "type": "http",
+        "scheme": "basic",
+        "description": "HTTP Basic auth using app_key as username and user_api_key as password"
+      }
+    }
+  },
+  "paths": {
+    "/network/campaign/publisher.json": {
+      "get": {
+        "operationId": "list_campaigns",
+        "summary": "List iHerb affiliate campaigns",
+        "description": "Returns all campaigns available to the publisher, including iHerb programs with their commission structures and status.",
+        "tags": ["campaigns"],
+        "parameters": [
+          {
+            "name": "status",
+            "in": "query",
+            "schema": { "type": "string", "enum": ["active", "paused", "closed"] },
+            "description": "Filter campaigns by status"
+          }
+        ]
+      }
+    },
+    "/network/campaign/publisher/{campaign_id}.json": {
+      "get": {
+        "operationId": "get_campaign",
+        "summary": "Get campaign details",
+        "description": "Returns detailed information about a specific campaign including commission tiers, terms, and tracking parameters.",
+        "tags": ["campaigns"],
+        "parameters": [
+          {
+            "name": "campaign_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Campaign ID"
+          }
+        ]
+      }
+    },
+    "/reporting/report_publisher/commission.json": {
+      "get": {
+        "operationId": "list_commissions",
+        "summary": "List commission data",
+        "description": "Returns commission reports for the publisher, showing earned commissions from iHerb conversions.",
+        "tags": ["reporting"],
+        "parameters": [
+          {
+            "name": "start_date",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Report start date (YYYY-MM-DD)"
+          },
+          {
+            "name": "end_date",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Report end date (YYYY-MM-DD)"
+          },
+          {
+            "name": "campaign_id",
+            "in": "query",
+            "schema": { "type": "string" },
+            "description": "Filter by campaign ID"
+          }
+        ]
+      }
+    },
+    "/reporting/report_publisher/conversion.json": {
+      "get": {
+        "operationId": "list_conversions",
+        "summary": "List conversion data",
+        "description": "Returns detailed conversion reports showing individual sales, order values, and commission amounts.",
+        "tags": ["reporting"],
+        "parameters": [
+          {
+            "name": "start_date",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Report start date (YYYY-MM-DD)"
+          },
+          {
+            "name": "end_date",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Report end date (YYYY-MM-DD)"
+          },
+          {
+            "name": "campaign_id",
+            "in": "query",
+            "schema": { "type": "string" },
+            "description": "Filter by campaign ID"
+          },
+          {
+            "name": "conversion_status",
+            "in": "query",
+            "schema": { "type": "string", "enum": ["approved", "pending", "rejected"] },
+            "description": "Filter by conversion status"
+          }
+        ]
+      }
+    },
+    "/network/campaign/{campaign_id}/product.json": {
+      "get": {
+        "operationId": "get_product_feed",
+        "summary": "Get product catalog feed",
+        "description": "Returns the product feed for a specific campaign, containing iHerb product listings with names, prices, categories, and deep link URLs.",
+        "tags": ["products"],
+        "parameters": [
+          {
+            "name": "campaign_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Campaign ID"
+          },
+          {
+            "name": "page",
+            "in": "query",
+            "schema": { "type": "integer", "default": 1 },
+            "description": "Page number for paginated results"
+          },
+          {
+            "name": "per_page",
+            "in": "query",
+            "schema": { "type": "integer", "default": 100 },
+            "description": "Number of products per page"
+          }
+        ]
+      }
+    },
+    "/network/campaign/{campaign_id}/tracking_link.json": {
+      "post": {
+        "operationId": "create_tracking_link",
+        "summary": "Create affiliate tracking link",
+        "description": "Generates a new affiliate tracking link (deep link) for a specific iHerb product or page URL.",
+        "tags": ["tracking"],
+        "parameters": [
+          {
+            "name": "campaign_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Campaign ID"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["destination_url"],
+                "properties": {
+                  "destination_url": {
+                    "type": "string",
+                    "description": "The iHerb product or page URL to create a tracking link for"
+                  },
+                  "sub_id": {
+                    "type": "string",
+                    "description": "Optional sub-tracking ID for analytics segmentation"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/reporting/report_publisher/click.json": {
+      "get": {
+        "operationId": "get_click_report",
+        "summary": "Get click report",
+        "description": "Returns click tracking data showing click counts, unique clicks, and click-through rates for affiliate links.",
+        "tags": ["reporting"],
+        "parameters": [
+          {
+            "name": "start_date",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Report start date (YYYY-MM-DD)"
+          },
+          {
+            "name": "end_date",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Report end date (YYYY-MM-DD)"
+          },
+          {
+            "name": "campaign_id",
+            "in": "query",
+            "schema": { "type": "string" },
+            "description": "Filter by campaign ID"
+          }
+        ]
+      }
+    },
+    "/reporting/report_publisher/performance.json": {
+      "get": {
+        "operationId": "get_performance",
+        "summary": "Get performance summary",
+        "description": "Returns aggregated performance metrics including clicks, conversions, revenue, and commission totals.",
+        "tags": ["reporting"],
+        "parameters": [
+          {
+            "name": "start_date",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Report start date (YYYY-MM-DD)"
+          },
+          {
+            "name": "end_date",
+            "in": "query",
+            "schema": { "type": "string", "format": "date" },
+            "description": "Report end date (YYYY-MM-DD)"
+          },
+          {
+            "name": "campaign_id",
+            "in": "query",
+            "schema": { "type": "string" },
+            "description": "Filter by campaign ID"
+          },
+          {
+            "name": "group_by",
+            "in": "query",
+            "schema": { "type": "string", "enum": ["day", "week", "month"] },
+            "description": "Group results by time period"
+          }
+        ]
+      }
+    }
+  }
+}