Skip to content
PubAdHub
groups

Publisher APIs

For publishers

Endpoints for publishers: brand list, brand list by traffic type, RTB, OpenRTB 2.5, reporting, product search, and publisher-hosted S2S conversion postbacks. Authenticate with AccessKey, PublisherKey, Publisher ID, or the OpenRTB Publisher Identity as documented on each page. Publisher S2S uses a URL you host — PubAdHub calls you.

arrow_back All API audiences

GET

Brand List API

Publisher

Retrieve merchant/brand records, including offer_id, brand name, merchant category, verification status, tracking URLs (homepage and deeplink), country eligibility, traffic restrictions, deal flags, and commission information.

https://statsapi.pubadhub.com/api/brands-list
Open API arrow_forward
GET

Brand List by Traffic Type

Publisher

Retrieve the Brand List merchant records that allow one traffic type, including tracking URLs, restrictions, and commission fields.

https://statsapi.pubadhub.com/api/brands-list-by-traffic-type
Open API arrow_forward
GET

RTB API

Publisher

Request ads in real time from the PubAdHub RTB Serving Engine and receive a bid response with a redirect (tracking) URL when an ad is available.

http://rtb.pubadhub.com/serving-engine
Open API arrow_forward
POST

OpenRTB 2.5

Publisher

Send one OpenRTB 2.5 bid request per auction. A fill returns HTTP 200 with a USD earnings-per-click price and a click URL. No ad returns HTTP 204.

http://rtb.pubadhub.com/openrtb/{PublisherKey}

2.5

Open API arrow_forward
POST

Revenue Share Report

Publisher

Retrieve click-level, source-level, or date-wise revenue share data including gross revenue, publisher earnings, click counts, transaction identifiers, and publisher tracking values (subid1–subid5).

https://statsapi.pubadhub.com/api/reporting/revenue-share
Open API arrow_forward
POST

Click-Level Conversion Report

Publisher

Retrieve click-level conversion data (click_id, revenue, click_date) with pagination metadata for a date range of at most 2 days.

https://statsapi.pubadhub.com/api/reporting/clicklevel
Open API arrow_forward
GET

Amazon Seller Product Search

Publisher

Search Amazon seller products with optional pagination and receive matching product records with a PubAdHub tracking URL for outbound clicks.

https://statsapi.pubadhub.com/api/amazon-seller-products/search
Open API arrow_forward
GET

Affiliate Product Search

Publisher

Search in-stock affiliate products by keyword and receive monetized redirect URLs for Shop / Buy clicks.

https://statsapi.pubadhub.com/api/products/search
Open API arrow_forward
GET

Publisher S2S Integration

Publisher

Receive conversion credits and cancellations from PubAdHub on an HTTP GET URL you host. Query parameters carry txnid, cid, payout, status, and edate.

https://publisher.example.com/s2s/postback
Open API arrow_forward