Skip to content
PubAdHub
Start

API Documentation

The official technical reference for PubAdHub APIs. Get your Access Key and Publisher Key from the PubAdHub Console, then select an endpoint below to explore and test.

rocket_launch Quick Start lock Authentication

Start with Credentials

vpn_key

Access Key

Used to authenticate requests for brand list and reporting endpoints.

Required For

Brand List Brand List by Traffic Type Revenue Share Click-Level Conv.
storefront

Publisher Key

Credential required for Amazon seller catalogs and affiliate product search.

Required For

Amazon Seller Product Search Affiliate Product Search
cell_tower

Publisher ID

Publisher Id from your Account Manager, sent as pubi on the RTB serving engine. OpenRTB 2.5 uses your Publisher Identity as the path value.

Required For

RTB OpenRTB 2.5
hub

Platform Access Key

Path credential for platform S2S conversion postbacks. Issued by your Account Manager — not a publisher AccessKey header.

Required For

S2S Postback

groups Publisher APIs

View all

For publishers integrating brand list, RTB, OpenRTB 2.5, reporting, product search, and publisher-hosted S2S postbacks.

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}
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

hub Platform APIs

View all

For platforms and affiliate / offer networks sending S2S conversion postbacks.

GET / POST

S2S Postback API

Platform

Server-to-server conversion postbacks for platforms / affiliate networks. Authenticate with a platform access_key in the URL path.

https://statsapi.pubadhub.com/api/postback/{access_key}
Open API arrow_forward