This method returns data about a specific publisher. To use this method, you need to pass a specific publisherId (domain name).
http://api.adbeat.com/v3/{api-key}/publisherinfo/{publisherId}
| Parameter Name | Meaning | Default Value | Notes |
|---|---|---|---|
| countryId | country filter | us |
e.g.
us (See countries) |
| platformId | platform filter | (no filtering) | e.g. desktop (See platforms) Currently only desktop is supported for a non-us countryId. Note: &platformId=mobile is not supported. |
| maxPublishers | maximum size of similarPublishers array | 10 | Maximum: 100 |
| maxAdvertisers | maximum size of recommendedAdvertisers array | 10 | Maximum: 100 |
| Field Name | Example | Notes |
|---|---|---|
| countryId | us | |
| platformId | desktop | See platforms |
| publisherPld | yahoo.com | Paid-level domain, which is different from publisherId if publisherId is a channel. |
| isChannel | true | Is the requested publisher actually a channel for a site? (e.g. finance.yahoo.com) |
| hasChannels | true | Does this publisherId have channels? |
| isSuperChannel | false | Is this publisherId actually a collection of channels? |
| publisherSize | 123039 | Relative "size" of publisher, based on summed adMetrics |
| description | The world's leading information portal on the Internet | |
| phrases |
[
{
"phrase": "information"
},
{
"phrase": "yahoo"
},
{
"phrase": "portal"
}
]
|
An array of information about key phrases in the publisher home page content. |
| iabCategories |
[
{
"iab": "News & Entertainment"
}
]
|
An array of information about IAB categories, in order from most to least definitive |
| recommendedAdvertisers |
[{
"advertiserId": "cnn.com",
"publishers": [{
"publisherId": "usatoday.com"
}, {
"publisherId": "washingtonpost.com"
}]
}]
|
An array of information about recommended advertisers, in order from best to worst, including the similar publishers on which each recommendation was based. |
| similarPublishers |
[{
"publisherId": "huffingtonpost.com",
"isChannel": "false",
"publisherSize": "1149003",
"description": "A liberal viewpoint of world news"
}, {
"phrases": [{
"phrase": "setter"
}, {
"phrase": "sync"
}]
}]
|
An array of information about similar publishers, in order from most similar to least similar, including the matching phrases. |
| apiUnits | 250 | The number of API units consumed by this request. |
msn.com do this:http://api.adbeat.com/v3/{api-key}/publisherinfo/msn.com
{
"countryId": "us",
"publisherPld": "msn.com",
"hasChannels": true,
"apiUnits": 250,
"statusMsg": "successful publisherInfo/msn.com request",
"similarPublishers": [{
"publisherId": "yahoo.com",
"description": "A new welcome to Yahoo. The new Yahoo experience makes it easier to discover the news and information that you care about most. It's the web ordered for you.",
"isChannel": false,
"publisherSize": 83492712,
"phrases": [{
"phrase": "messenger"
}, {
"phrase": "sign"
}, {
"phrase": "legend"
}, {
"phrase": "quote"
}, {
"phrase": "game"
}, {
"phrase": "robin"
}, {
"phrase": "williams"
}, {
"phrase": "talk"
}, {
"phrase": "news"
}, {
"phrase": "search"
}, {
"phrase": "weather"
}, {
"phrase": "change"
}, {
"phrase": "result"
}, {
"phrase": "market"
}, {
"phrase": "home"
}, {
"phrase": "money"
}, {
"phrase": "update"
}, {
"phrase": "photo"
}, {
"phrase": "video"
}]
}, {
"publisherId": "aol.com",
"description": "",
"isChannel": false,
"publisherSize": 30417600,
"phrases": []
}, {
"publisherId": "myway.com",
"description": "My Way is a web portal and search engine like Yahoo!, but without any banners, pop-ups or spam. No ads means more room for our terrific personalized features like weather, news, sports, finance, entertainment and more. And the My Way search engine is powered by Google, so it's incredibly accurate. Make My Way your way to search the Web!",
"isChannel": false,
"publisherSize": 2186582,
"phrases": [{
"phrase": "celebrity"
}, {
"phrase": "weather"
}, {
"phrase": "portal"
}, {
"phrase": "entertainment"
}, {
"phrase": "photo"
}, {
"phrase": "news"
}, {
"phrase": "search"
}, {
"phrase": "item"
}, {
"phrase": "result"
}, {
"phrase": "home"
}, {
"phrase": "content"
}, {
"phrase": "sport"
}, {
"phrase": "| |"
}]
}, {
"publisherId": "ninemsn.com.au",
"description": "Get all the latest local and international news, sport, movies, money, travel and more at ninemsn. Login to Outlook.com, formerly Hotmail and access Skype at ninemsn.",
"isChannel": false,
"publisherSize": 115885,
"phrases": [{
"phrase": "outlook"
}, {
"phrase": "hotmail"
}, {
"phrase": "skype"
}, {
"phrase": "sport"
}, {
"phrase": "suicide"
}, {
"phrase": "actor"
}, {
"phrase": "williams"
}, {
"phrase": "couple"
}, {
"phrase": "news"
}, {
"phrase": "california"
}, {
"phrase": "entertainment"
}, {
"phrase": "movie"
}, {
"phrase": "money"
}, {
"phrase": "| |"
}, {
"phrase": "photo"
}, {
"phrase": "home"
}, {
"phrase": "search"
}]
}, {
"publisherId": "weather.com",
"description": "The Weather Channel and weather.com provide a national and local weather forecast for cities, as well as weather radar, report and hurricane coverage.",
"isChannel": false,
"publisherSize": 28812090,
"phrases": [{
"phrase": "weather"
}, {
"phrase": "outlook"
}, {
"phrase": "ghost"
}, {
"phrase": "window"
}, {
"phrase": "town"
}, {
"phrase": "update"
}, {
"phrase": "tip"
}, {
"phrase": "photo"
}, {
"phrase": "week"
}, {
"phrase": "video"
}]
}, {
"publisherId": "entertainment.msn.com",
"description": "Entertainment articles, galleries, news and reviews on the top stars and the latest gossip on MSN Entertainment",
"isChannel": true,
"publisherSize": 6359814,
"phrases": [{
"phrase": "gossip"
}, {
"phrase": "celebrity"
}, {
"phrase": "msn"
}, {
"phrase": "entertainment"
}, {
"phrase": "suicide"
}, {
"phrase": "theater"
}, {
"phrase": "williams"
}, {
"phrase": "photo"
}, {
"phrase": "week"
}, {
"phrase": "news"
}, {
"phrase": "movie"
}, {
"phrase": "video"
}, {
"phrase": "search"
}]
}, {
"publisherId": "answers.yahoo.com",
"description": "Yahoo Answers",
"isChannel": true,
"publisherSize": 50751728,
"phrases": [{
"phrase": "vietnam"
}, {
"phrase": "suicide"
}, {
"phrase": "actor"
}, {
"phrase": "robin"
}, {
"phrase": "williams"
}, {
"phrase": "film"
}]
}, {
"publisherId": "walmart.com",
"description": "Online shopping for the largest selection of electronics, home furnishings, video games, baby gear and more. Shop online and save money to live better, at Walmart.com.",
"isChannel": false,
"publisherSize": 24872476,
"phrases": [{
"phrase": "shopping"
}, {
"phrase": "money"
}, {
"phrase": "game"
}, {
"phrase": "home"
}, {
"phrase": "service"
}, {
"phrase": "video"
}, {
"phrase": "movie"
}, {
"phrase": "sport"
}, {
"phrase": "tip"
}, {
"phrase": "photo"
}]
}, {
"publisherId": "nydailynews.com",
"description": "Find breaking US news, local New York news coverage, sports, entertainment news, celebrity gossip, autos, videos and photos at nydailynews.com.",
"isChannel": false,
"publisherSize": 14815314,
"phrases": [{
"phrase": "gossip"
}, {
"phrase": "robin"
}, {
"phrase": "celebrity"
}, {
"phrase": "news"
}, {
"phrase": "man"
}, {
"phrase": "entertainment"
}, {
"phrase": "sport"
}, {
"phrase": "game"
}, {
"phrase": "photo"
}, {
"phrase": "service"
}, {
"phrase": "video"
}, {
"phrase": "search"
}]
}, {
"publisherId": "jezebel.com",
"description": "Celebrity, Sex, Fashion for Women. Without Airbrushing.",
"isChannel": false,
"publisherSize": 8976484,
"phrases": [{
"phrase": "stodden"
}, {
"phrase": "courtney"
}, {
"phrase": "celebrity"
}, {
"phrase": "suicide"
}, {
"phrase": "actor"
}, {
"phrase": "robin"
}, {
"phrase": "williams"
}, {
"phrase": "film"
}, {
"phrase": "photo"
}]
}],
"iabCategories": [{
"iab": "News"
}],
"platformId": "desktop",
"isSuperChannel": false,
"requestParameters": {
"publisherId": "msn.com"
},
"statusCode": 200,
"isChannel": false,
"description": "MSN is Microsoft's portal, offering news, sports, money, games, videos, entertainment & celebrity gossip, weather, shopping and more great content, as well as Windows Live services such as Skype, Outlook.com, Hotmail and Messenger.",
"recommendedAdvertisers": [{
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "aol.com"
}, {
"publisherId": "myway.com"
}, {
"publisherId": "weather.com"
}, {
"publisherId": "walmart.com"
}, {
"publisherId": "nydailynews.com"
}, {
"publisherId": "zillow.com"
}, {
"publisherId": "voices.yahoo.com"
}],
"advertiserSize": 259996,
"advertiserId": "verizon.com"
}, {
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "answers.yahoo.com"
}, {
"publisherId": "walmart.com"
}, {
"publisherId": "voices.yahoo.com"
}],
"advertiserSize": 230325,
"advertiserId": "yahoo.com"
}, {
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "aol.com"
}, {
"publisherId": "ninemsn.com.au"
}, {
"publisherId": "entertainment.msn.com"
}, {
"publisherId": "nydailynews.com"
}, {
"publisherId": "jezebel.com"
}, {
"publisherId": "eonline.com"
}, {
"publisherId": "voices.yahoo.com"
}],
"advertiserSize": 203703,
"advertiserId": "americanexpress.com"
}, {
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "weather.com"
}, {
"publisherId": "answers.yahoo.com"
}, {
"publisherId": "zillow.com"
}],
"advertiserSize": 178006,
"advertiserId": "ramtrucks.com"
}, {
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "answers.yahoo.com"
}, {
"publisherId": "voices.yahoo.com"
}],
"advertiserSize": 174872,
"advertiserId": "hobbylobby.com"
}, {
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "myway.com"
}, {
"publisherId": "weather.com"
}, {
"publisherId": "answers.yahoo.com"
}, {
"publisherId": "walmart.com"
}],
"advertiserSize": 101520,
"advertiserId": "geico.com"
}, {
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "answers.yahoo.com"
}, {
"publisherId": "jezebel.com"
}],
"advertiserSize": 86239,
"advertiserId": "netflix.com"
}, {
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "nydailynews.com"
}, {
"publisherId": "jezebel.com"
}, {
"publisherId": "eonline.com"
}],
"advertiserSize": 75861,
"advertiserId": "sprint.com"
}, {
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "myway.com"
}, {
"publisherId": "weather.com"
}, {
"publisherId": "voices.yahoo.com"
}],
"advertiserSize": 74147,
"advertiserId": "homedepot.com"
}, {
"publishers": [{
"publisherId": "yahoo.com"
}, {
"publisherId": "weather.com"
}, {
"publisherId": "voices.yahoo.com"
}],
"advertiserSize": 71674,
"advertiserId": "howlifeworks.com"
}],
"publisherSize": 116573696,
"phrases": [{
"phrase": "pg13"
}, {
"phrase": "a.m."
}, {
"phrase": "msn"
}, {
"phrase": "s portal"
}, {
"phrase": "market update"
}, {
"phrase": "dong"
}, {
"phrase": "stodden"
}, {
"phrase": "last change"
}, {
"phrase": "various item"
}, {
"phrase": "make/model"
}, {
"phrase": "much flavor"
}, {
"phrase": ":40"
}, {
"phrase": ":50"
}, {
"phrase": "northern california home"
}, {
"phrase": "helen mirren"
}, {
"phrase": "outlook"
}, {
"phrase": "(eg"
}, {
"phrase": "hanoi"
}, {
"phrase": "popular this week"
}, {
"phrase": ":00"
}, {
"phrase": "leesburg"
}, {
"phrase": "hotmail"
}, {
"phrase": "mirren"
}, {
"phrase": "affordability"
}, {
"phrase": "best result"
}, {
"phrase": "amc"
}, {
"phrase": ".g."
}, {
"phrase": "lan"
}, {
"phrase": "actor and comedian robin williams"
}, {
"phrase": "versatility"
}, {
"phrase": "mover"
}, {
"phrase": "courtney"
}, {
"phrase": "skype"
}, {
"phrase": "countryside"
}, {
"phrase": "replica"
}, {
"phrase": "| search"
}, {
"phrase": "mazda"
}, {
"phrase": "foodie"
}, {
"phrase": "messenger"
}, {
"phrase": "vietnam"
}, {
"phrase": "microsoft"
}, {
"phrase": "cinema"
}, {
"phrase": "apparent suicide"
}, {
"phrase": "shopping"
}, {
"phrase": "efficiency"
}, {
"phrase": "gossip"
}, {
"phrase": "ghost"
}, {
"phrase": "weather"
}, {
"phrase": "symbol"
}, {
"phrase": "portal"
}, {
"phrase": "square"
}, {
"phrase": "village"
}, {
"phrase": "suicide"
}, {
"phrase": "fox"
}, {
"phrase": "authority"
}, {
"phrase": "theater"
}, {
"phrase": "legend"
}, {
"phrase": "flavor"
}, {
"phrase": "feet"
}, {
"phrase": "sport"
}, {
"phrase": "| |"
}, {
"phrase": "actor"
}, {
"phrase": "safety"
}, {
"phrase": "festival"
}, {
"phrase": "quote"
}, {
"phrase": "paper"
}, {
"phrase": "robin"
}, {
"phrase": "celebrity"
}, {
"phrase": "williams"
}, {
"phrase": "film"
}, {
"phrase": "talk"
}, {
"phrase": "couple"
}, {
"phrase": "editor"
}, {
"phrase": "window"
}, {
"phrase": "town"
}, {
"phrase": "model"
}, {
"phrase": "california"
}, {
"phrase": "man"
}, {
"phrase": "change"
}, {
"phrase": "item"
}, {
"phrase": "entertainment"
}, {
"phrase": "movie"
}, {
"phrase": "result"
}, {
"phrase": "market"
}, {
"phrase": "house"
}, {
"phrase": "sign"
}, {
"phrase": "money"
}, {
"phrase": "content"
}, {
"phrase": "update"
}, {
"phrase": "school"
}, {
"phrase": "search"
}, {
"phrase": "tip"
}, {
"phrase": "game"
}, {
"phrase": "event"
}, {
"phrase": "photo"
}, {
"phrase": "week"
}, {
"phrase": "service"
}, {
"phrase": "video"
}, {
"phrase": "home"
}, {
"phrase": "news"
}],
"handler": "publisherInfo"
}