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-667c328485a6",
"seatbid": [
{
"bid": [
{
"id": "bid123videoabc",
"impid": "a2cdc721-5002-3a4c-ad74-4cc1ff6b2333",
"price": 0.094,
"burl": "https://click.inhousead.net/ortbburl/vidtoken123?token=securetoken123&id=${AUCTION_ID}&price=${AUCTION_PRICE}&bidId=${AUCTION_BID_ID}&impId=${AUCTION_IMP_ID}¤cy=${AUCTION_CURRENCY}",
"adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"4.0\"><Ad id=\"1234\"><InLine><AdSystem>InhouseAd</AdSystem><AdTitle>Sample Video Ad</AdTitle><Impression><![CDATA[https://click.inhousead.net/ortbimp/vidtoken123?token=securetoken123&type=1]]></Impression><Creatives><Creative><Linear><Duration>00:00:30</Duration><MediaFiles><MediaFile delivery=\"progressive\" type=\"video/mp4\" width=\"414\" height=\"278\" bitrate=\"800\" scalable=\"true\" maintainAspectRatio=\"true\"><![CDATA[https://cdn.adserver.com/video/sample-video-ad.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>",
"adid": "video-ad-789",
"crid": "creative-789",
"adomain": [
"advertiser-example.com"
]
}
],
"seat": "ssp123"
}
],
"bidid": "resp-vid-bid-001",
"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": "ssp123",
"bid": [
{
"id": "bid123videoabc",
"impid": "a2cdc721-5002-3a4c-ad74-4cc1ff6b2333",
"price": 0.094,
"burl": "https://click.inhousead.net/ortbburl/vidtoken123?token=securetoken123&id=${AUCTION_ID}&price=${AUCTION_PRICE}&bidId=${AUCTION_BID_ID}&impId=${AUCTION_IMP_ID}¤cy=${AUCTION_CURRENCY}",
"adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"4.0\"><Ad id=\"video-ad-789\"><InLine><AdSystem version=\"1.0\">InhouseAd</AdSystem><AdTitle>Sample In-App Video Ad</AdTitle><Impression><![CDATA[https://click.inhousead.net/ortbimp/vidtoken123?token=securetoken123&type=1]]></Impression><Creatives><Creative id=\"creative-789\"><Linear><Duration>00:00:30</Duration><TrackingEvents><Tracking event=\"start\"><![CDATA[https://track.inhousead.net/event/start?bidid=bid123videoabc]]></Tracking><Tracking event=\"complete\"><![CDATA[https://track.inhousead.net/event/complete?bidid=bid123videoabc]]></Tracking></TrackingEvents><MediaFiles><MediaFile delivery=\"progressive\" type=\"video/mp4\" width=\"414\" height=\"278\" scalable=\"true\" maintainAspectRatio=\"true\" bitrate=\"800\"><![CDATA[https://cdn.adserver.com/video/sample-video-ad.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>",
"adid": "video-ad-789",
"crid": "creative-789",
"adomain": [
"advertiser-example.com"
],
"bundle": "com.advertiser.coolapp"
}
]
}
],
"bidid": "resp-vid-bid-001",
"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/statistics/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.