VIDEO oRTB
VIDEO oRTB Integration
Our banner integration is using standard oRTB 2.6 protocol.
VIDEO oRTB endpoint
http://feed.inhousead.net/ortb?pid=REPLACE
Parameters
| pid | Required | Your feed ID |
Video Web Request example
{
"id": "e06c50dd-548c-0adc-07b9-667c328abc12",
"imp": [
{
"id": "a2cdc721-5002-3a4c-ad74-4cc1ff6b9876",
"video": {
"mimes": [
"video/mp4",
"video/mpeg",
"video/webm",
"video/quicktime",
"application/javascript"
],
"minduration": 5,
"maxduration": 60,
"protocols": [
2,
3,
5,
6,
7,
8
],
"w": 414,
"h": 278,
"linearity": 1,
"sequence": 1,
"battr": [
13,
14
],
"maxextended": 30,
"minbitrate": 300,
"maxbitrate": 1500,
"boxingallowed": 1,
"playbackmethod": [
2,
6,
3
],
"delivery": [
2
],
"pos": 4,
"api": [
1,
2
],
"placement": 1,
"plcmt": 1
},
"bidfloor": 0.4,
"bidfloorcur": "USD",
"secure": 1
}
],
"site": {
"id": "438",
"name": "vidmedia.stream",
"domain": "vidmedia.stream",
"cat": [
"IAB1-5"
],
"sectioncat": [
"IAB1-5"
],
"pagecat": [
"IAB1-5"
],
"publisher": {
"id": "631"
},
"page": "https://vidmedia.stream/watch/2026-fantasy-world-season-3.html",
"ref": "https://vidmedia.stream/watch/2026-fantasy-world-season-3.html"
},
"device": {
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_6_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.6 Mobile/15E148 Safari/604.1",
"geo": {
"lat": 41.0461,
"lon": 28.9934,
"type": 2,
"country": "TUR",
"city": "Şişli"
},
"ip": "46.104.14.111",
"devicetype": 1,
"os": "iOS",
"js": 1,
"language": "ru"
},
"user": {
"id": "1554cc02-295b-ec6a-1b65-02c9ff123abc",
"buyeruid": "e3cc5c62-eb01-8d4a-20af-5ae11185ffff",
"geo": {
"lat": 41.0461,
"lon": 28.9934,
"type": 2,
"country": "TUR",
"city": "Şişli"
}
},
"publisher": {
"id": "631",
"domain": "vidmedia.stream"
},
"at": 1,
"tmax": 500,
"cur": [
"USD"
],
"source": {
"schain": {
"complete": 1,
"ver": "1.0",
"nodes": [
{
"asi": "adpartner.io",
"sid": "438",
"rid": "e06c50dd-548c-0adc-07b9-667c328abc12",
"hp": 1
}
]
}
},
"regs": {}
}Video Web Response example
{
"id": "e06c50dd-548c-0adc-07b9-667c328abc12",
"seatbid": [
{
"seat": "ssp123",
"bid": [
{
"id": "1a2b3c4d",
"impid": "a2cdc721-5002-3a4c-ad74-4cc1ff6b9876",
"price": 1.25,
"adid": "vid_ad_987",
"nurl": "https://win.tracker.example.com/win?bid=${AUCTION_PRICE}",
"adm": "<VAST version=\"4.0\"> ... </VAST>",
"adomain": [
"advertiser-brand.com"
],
"cid": "campaign123",
"crid": "creative456",
"cat": [
"IAB1-5"
],
"attr": [
1,
3
],
"api": 2,
"protocol": 3,
"mediarating": 1,
"w": 414,
"h": 278
}
]
}
],
"bidid": "resp-abc-20260123-xyz",
"cur": "USD"
}Video In‑App Request example
{
"id": "f72e93aa-7b2d-91fc-2bff-8cfa5432bcde",
"imp": [
{
"id": "b3eefa18-c702-41df-b3ab-6ef91234dd56",
"video": {
"mimes": [
"video/mp4",
"video/webm"
],
"minduration": 5,
"maxduration": 30,
"protocols": [
2,
3,
5,
6
],
"w": 360,
"h": 640,
"linearity": 1,
"sequence": 1,
"battr": [
13,
14
],
"maxextended": 0,
"minbitrate": 200,
"maxbitrate": 1200,
"boxingallowed": 0,
"playbackmethod": [
2,
3
],
"delivery": [
2
],
"pos": 1,
"api": [
1,
2
],
"placement": 2,
"plcmt": 3
},
"bidfloor": 0.5,
"bidfloorcur": "USD",
"secure": 1
}
],
"app": {
"id": "com.example.videoplay",
"name": "Example Video Play",
"bundle": "com.example.videoplay",
"storeurl": "https://play.example.com/store/app/examplevideoplay",
"cat": [
"IAB1"
],
"sectioncat": [
"IAB1"
],
"publisher": {
"id": "802",
"name": "Example App Co"
}
},
"device": {
"ua": "Mozilla/5.0 (Linux; Android 14; Pixel 7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Mobile Safari/537.36",
"geo": {
"lat": 37.7749,
"lon": -122.4194,
"type": 1,
"country": "USA",
"city": "San Francisco"
},
"ip": "203.0.113.42",
"devicetype": 1,
"make": "Google",
"model": "Pixel 7",
"os": "Android",
"osv": "14",
"js": 1,
"language": "en"
},
"user": {
"id": "a724fab9-cde4-47f9-9213-55bb9876efab",
"buyeruid": "b9cd72a6-34e1-4f90-98cd-1234abcdfe56"
},
"at": 2,
"tmax": 600,
"cur": [
"USD"
],
"source": {
"schain": {
"complete": 1,
"ver": "1.0",
"nodes": [
{
"asi": "mobileexchange.io",
"sid": "802",
"rid": "f72e93aa-7b2d-91fc-2bff-8cfa5432bcde",
"hp": 1
}
]
}
},
"regs": {
"coppa": 0
}
}Video In‑App Response example
{
"id": "f72e93aa-7b2d-91fc-2bff-8cfa5432bcde",
"seatbid": [
{
"seat": "ssp456",
"bid": [
{
"id": "resp-bid-002",
"impid": "b3eefa18-c702-41df-b3ab-6ef91234dd56",
"price": 1.05,
"adid": "inapp_ad_201",
"nurl": "https://track.mobilepartner.io/win?price=${AUCTION_PRICE}",
"adm": "<VAST version=\"4.0\"> ... </VAST>",
"adomain": [
"coolappads.example"
],
"cid": "cmp-mobile-234",
"crid": "crid-mobile-567",
"bundle": "com.advertiser.coolapp",
"cat": [
"IAB1"
],
"attr": [
1
],
"api": 1,
"protocol": 2,
"mediarating": 1,
"w": 360,
"h": 640
}
]
}
],
"bidid": "resp-bidid-998877",
"cur": "USD"
}VIDEO oRTB Statistic API
You can retrieve statistics using two available methods:
Method 1: Using API Endpoint and API Token
You can access stats programmatically using a dedicated API URL and a personal API token.
Requirements:
API Link (provided by your account manager)
API Token (also issued by your manager)
Authentication:
You must include the API token in the Authorization header using the Bearer scheme.
Example Header:
Authorization: Bearer YOUR_API_TOKEN
| pubfeed_id | Required | Your feed ID |
API Link By Date
https://platform.inhousead.net/ortb/api/statistics/pubfeed/?pubfeed_id=REPLACE&start_date=2025.09.25&end_date=2025.09.25&groupby=date
Method 2: Using Swagger Interface
You can also access statistics via the Swagger UI, which provides an interactive interface to query stats.
Swagger URL:
https://platform.inhousead.net/ortb/api/schema/swagger-ui/
Steps to Use:
1. Authorise using your API token;
2. Specify the date;
3. Select your preferred grouping (by date, country, subid, hour or pubfeed_id);
4. Execute the query and review the results directly in the Swagger UI.
If you require any help, please contact your account manager.