Sign in | Sign up

publisherInfo

This method returns data about a specific publisher. To use this method, you need to pass a specific publisherId (domain name).

Request Cost: 250 units, Result Cost: none

URL Format

http://api.adbeat.com/v3/{api-key}/publisherinfo/{publisherId}

Parameters

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

Return Fields

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.

Usage Example(s)

To get information about the publisher msn.com do this:

http://api.adbeat.com/v3/{api-key}/publisherinfo/msn.com

JSON Response

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