Authenticate with Admitad API using OAuth2 client credentials.

If client_id / client_secret are empty, falls back to ADMITAD_CLIENT_ID / ADMITAD_CLIENT_SECRET environment variables.

Returns username, webmaster_id, token_expires_in seconds.

Return current authenticated Admitad user info (account details, balance, etc.).

List affiliate campaigns (partner programs) available to this publisher.

Args: limit: Max results per page (1–500). offset: Pagination offset. status: Filter by connection status: active | pending | declined | all.

Returns list of campaigns with id, name, site_url, rating, and feed_url if available.

Get product feed URLs for a specific campaign.

Args: campaign_id: Admitad campaign ID (from list_campaigns).

Returns list of feed objects with id, name, url, format, and item count.

Download and parse a product feed (YML XML or CSV) from the given URL.

Args: feed_url: Direct URL to the feed file (from get_campaign_feeds). limit: Maximum number of products to return (default 100, max 5000).

Returns list of products with all available fields (name, price, url, picture, etc.).

Download a product feed and search for products matching a query string.

Args: feed_url: Direct URL to the feed file. query: Search string (case-insensitive substring match). field: Field to search in: name | vendor | categoryid | description | any. limit: Max products to return (default 20).

Returns matching products.

List product categories for a campaign (from campaign detail).

Args: campaign_id: Admitad campaign ID.

Returns categories embedded in the campaign object.

Get available coupons/promo codes from Admitad.

Args: campaign_id: Filter by campaign ID (optional, leave empty for all). limit: Max results.

Returns list of coupons with code, discount, validity dates.