Documentation

Referrals API

The Referrals API returns the referring websites for the given domain, and traffic share per referer



Parameters

Params Description
Domain Enter your target domain including only the top-level and second-level names, ie: "cnn.com", "edition.cnn.com"
Start Month (start_date) Start Month (YYYY-MM)
End Month (end_date) End Month (YYYY-MM)
Main Domain (main_domain_only) True /False
True returns data for main domain only
False returns data for subdomains as well.
UserKey (api_key) Enter your unique API Key
Granularity (granularity) Daily/Weekly/Monthly
Returns data in requested format


Example: Referrals input for “cnn.com”

{
https://api.similarweb.com/v1/website/cnn.com/traffic-sources/referrals?api_key={UserKey}&start_date=2016-01&end_date=2016-01&main_domain_only=false
}

Example: Referrals output for “cnn.com”

{
{
	"meta": {
		"request": {
			"main_domain_only": false,
			"domain": "cnn.com",
			"start_date": "2016-01-01",
			"end_date": "2016-01-01",
			"country": "world"
		},
		"status": "Success",
		"last_updated": "2016-06-01"
	},
	"referrals": [
		{
			"share": 0.20751182132695256,
			"domain": "drudgereport.com"
		},
		{
			"share": 0.1773667118288003,
			"domain": "da.feedsportal.com"
		},
		{
			"share": 0.05114633567204356,
			"domain": "ighome.com"
		},
		{
			"share": 0.0369271396043146,
			"domain": "fark.com"
		},
		{
			"share": 0.02166427417729717,
			"domain": "aol.com"
		},
		{
			"share": 0.019559232628086575,
			"domain": "huffingtonpost.com"
		},
		{
			"share": 0.01596907826947777,
			"domain": "feedly.com"
		},
		{
			"share": 0.015046419669068337,
			"domain": "rense.com"
		},
		{
			"share": 0.01486053237479289,
			"domain": "realclearpolitics.com"
		},
		{
			"share": 0.011272733617755323,
			"domain": "searchlock.com"
		},
		{
			"share": 0.010570521411752982,
			"domain": "cdn.flipboard.com"
		},
		{
			"share": 0.006359768803395441,
			"domain": "refdesk.com"
		},
		{
			"share": 0.00617615927127056,
			"domain": "msn.com"
		},
		{
			"share": 0.005610871752253922,
			"domain": "venturead.com"
		},
		{
			"share": 0.005533742561701005,
			"domain": "protopage.com"
		},
		{
			"share": 0.0055314053013395805,
			"domain": "symbaloo.com"
		},
		{
			"share": 0.005477235099458955,
			"domain": "nytimes.com"
		},
		{
			"share": 0.005221908399244659,
			"domain": "wnd.com"
		},
		{
			"share": 0.00521257604888156,
			"domain": "allmyfaves.com"
		},
		{
			"share": 0.004854111510110708,
			"domain": "thedailybeast.com"
		},
		{
			"share": 0.004603214415236404,
			"domain": "search.myway.com"
		},
		{
			"share": 0.004341668874066416,
			"domain": "hotsheet.com"
		},
		{
			"share": 0.00430063551226628,
			"domain": "slashdot.org"
		},
		{
			"share": 0.004129905771875275,
			"domain": "forums.somethingawful.com"
		},
		{
			"share": 0.004122441937964435,
			"domain": "int.search.myway.com"
		},
		{
			"share": 0.003949388523517558,
			"domain": "ustart.org"
		},
		{
			"share": 0.0038604217890089837,
			"domain": "zergnet.com"
		},
		{
			"share": 0.00379090876411368,
			"domain": "i.maxthon.com"
		},
		{
			"share": 0.0037889388413570634,
			"domain": "hotair.com"
		},
		{
			"share": 0.0036402550718293543,
			"domain": "bleacherreport.com"
		},
		{
			"share": 0.0032610470488811222,
			"domain": "search.xfinity.com"
		},
		{
			"share": 0.003076454370413679,
			"domain": "lucianne.com"
		},
		{
			"share": 0.0029493629740002763,
			"domain": "besthomepageever.com"
		},
		{
			"share": 0.0028312472109398744,
			"domain": "t.umblr.com"
		},
		{
			"share": 0.0027446370387621075,
			"domain": "foxtrotalpha.jalopnik.com"
		},
		{
			"share": 0.0026641648102452915,
			"domain": "202020.net"
		},
		{
			"share": 0.002657154697307146,
			"domain": "ceoexpress.com"
		},
		{
			"share": 0.0026548926881459936,
			"domain": "newsnow.co.uk"
		},
		{
			"share": 0.0026385145771216805,
			"domain": "washingtonpost.com"
		},
		{
			"share": 0.002550533075649247,
			"domain": "pjmedia.com"
		},
		{
			"share": 0.0025241527612071724,
			"domain": "newsconnect.net"
		},
		{
			"share": 0.0025201126494562762,
			"domain": "neogaf.com"
		},
		{
			"share": 0.00246925000196628,
			"domain": "flightaware.com"
		},
		{
			"share": 0.0024627463990168734,
			"domain": "cracked.com"
		},
		{
			"share": 0.0023806975500980355,
			"domain": "cnnexpansion.com"
		},
		{
			"share": 0.0023101555724431852,
			"domain": "alexa.com"
		},
		{
			"share": 0.002301798127951328,
			"domain": "mywot.com"
		},
		{
			"share": 0.002247609115494258,
			"domain": "cnn.co.jp"
		},
        
		{
			"share": 0.002227853129298699,
			"domain": "theatlantic.com"
		},
		{
			"share": 0.002118242232872581,
			"domain": "bbc.com"
		},
		{
			"share": 0.0021095366761495426,
			"domain": "freerepublic.com"
		},
		{
			"share": 0.002062359162477041,
			"domain": "rss.ighome.com"
		},
		{
			"share": 0.0020327775851049167,
			"domain": "salon.com"
		},
		{
			"share": 0.0020231606999929637,
			"domain": "news.ycombinator.com"
		},
		{
			"share": 0.0020204058022408778,
			"domain": "dailykos.com"
		},
		{
			"share": 0.0018674023177513114,
			"domain": "memeorandum.com"
		},
		{
			"share": 0.0018206542427896086,
			"domain": "gawker.com"
		},
		{
			"share": 0.0018110856576981655,
			"domain": "foxnews.com"
		},
		{
			"share": 0.0017274654544864071,
			"domain": "thedailyhomepages.com"
		},
		{
			"share": 0.0017185642676148486,
			"domain": "realclearmarkets.com"
		},
		{
			"share": 0.001714451250621071,
			"domain": "vocm.com"
		},
		{
			"share": 0.0017076235213210659,
			"domain": "news.komando.com"
		},
		{
			"share": 0.0017012930866052863,
			"domain": "meneame.net"
		},
		{
			"share": 0.001675953050265501,
			"domain": "1stheadlines.com"
		},
		{
			"share": 0.0016684825845253374,
			"domain": "ar15.com"
		},
		{
			"share": 0.001632755222077865,
			"domain": "hp.myway.com"
		},
		{
			"share": 0.001607932990421048,
			"domain": "drudge.com"
		},
		{
			"share": 0.0015964537055072523,
			"domain": "kadaza.com"
		},
		{
			"share": 0.0015712556948216322,
			"domain": "sploid.gizmodo.com"
		},
		{
			"share": 0.0015628076083383032,
			"domain": "democraticunderground.com"
		},
		{
			"share": 0.0015484674329544572,
			"domain": "saigonbao.com"
		},
		{
			"share": 0.0015217758766327412,
			"domain": "excite.com"
		},
		{
			"share": 0.0014248111530966727,
			"domain": "frontpage.pch.com"
		},
		{
			"share": 0.0013863542019691638,
			"domain": "mediaite.com"
		},
		{
			"share": 0.0013593836437654201,
			"domain": "spiritdaily.com"
		},
		{
			"share": 0.001347512219352748,
			"domain": "oregonlive.com"
		},
		{
			"share": 0.0013420513892020262,
			"domain": "slate.com"
		},
		{
			"share": 0.0013165204884061513,
			"domain": "godlikeproductions.com"
		},
		{
			"share": 0.0013158626794469365,
			"domain": "pcdvd.com.tw"
		},
		{
			"share": 0.0013007798993717446,
			"domain": "news.kadaza.com"
		},
		{
			"share": 0.001271124096135449,
			"domain": "newsmap.jp"
		},
		{
			"share": 0.0012359016746160336,
			"domain": "hao123.com"
		},
		{
			"share": 0.0012353153729152452,
			"domain": "gamefaqs.com"
		},
		{
			"share": 0.001228577184839074,
			"domain": "thinkprogress.org"
		},
		{
			"share": 0.0012180410345844427,
			"domain": "vox.com"
		},
		{
			"share": 0.0011939163072330658,
			"domain": "theguardian.com"
		},
		{
			"share": 0.0011834886617626361,
			"domain": "al.com"
		},
		{
			"share": 0.0011711785973519552,
			"domain": "cnnmexico.com"
		},
		{
			"share": 0.001150809851274238,
			"domain": "ebizmba.com"
		},
		{
			"share": 0.0011355034077983417,
			"domain": "time.com"
		},
		{
			"share": 0.0011085586701151363,
			"domain": "igoogleportal.com"
		},
		{
			"share": 0.0011048230149038342,
			"domain": "tech.slashdot.org"
		},
		{
			"share": 0.0010867017355147763,
			"domain": "mmo-champion.com"
		},
		{
			"share": 0.0010850680386059234,
			"domain": "remolacha.net"
		},
		{
			"share": 0.001076550727718406,
			"domain": "gizmodo.com"
		},
		{
			"share": 0.0010744509039932676,
			"domain": "infowars.com"
		},
		{
			"share": 0.0010690446733650143,
			"domain": "baynews9.com"
		},
		{
			"share": 0.0010681078095524028,
			"domain": "news.rediff.com"
		},
		{
			"share": 0.0010428011584656459,
			"domain": "my.parallaxsearch.com"
		},
		{
			"share": 0.0010379511951936326,
			"domain": "huffingtonpost.ca"
		},
		{
			"share": 0.001001691786975566,
			"domain": "majfud.org"
		},
		{
			"share": 0.0009864679724730964,
			"domain": "microsoft.com"
		},
		{
			"share": 0.000982415191213022,
			"domain": "gillespieinternet.com"
		},
		{
			"share": 0.0009694100228023758,
			"domain": "breitbart.com"
		},
		{
			"share": 0.0009523236195639496,
			"domain": "nymag.com"
		},
		{
			"share": 0.0009370268721067915,
			"domain": "cybermal.com"
		},
		{
			"share": 0.0009330885390086728,
			"domain": "theblaze.com"
		},
		{
			"share": 0.0009302815972068411,
			"domain": "topweb-plus.net"
		},
		{
			"share": 0.0009128351284207301,
			"domain": "wolfe.unh.edu"
		},
		{
			"share": 0.000889563735166469,
			"domain": "forum.bodybuilding.com"
		},
		{
			"share": 0.0008873448912003221,
			"domain": "thebigproject.co.uk"
		},
		{
			"share": 0.0008865564994728224,
			"domain": "businessinsider.com"
		},
		{
			"share": 0.0008773539043478394,
			"domain": "sterba.com"
		},
		{
			"share": 0.0008709210400156734,
			"domain": "search.mycurrentnewsxp.com"
		},
		{
			"share": 0.0008707715040934598,
			"domain": "marketwatch.com"
		},
		{
			"share": 0.0008666502575429698,
			"domain": "ilikeberniebut.com"
		},
		{
			"share": 0.0008550823110289767,
			"domain": "zerohedge.com"
		},
		{
			"share": 0.0008539520018619322,
			"domain": "medpagetoday.com"
		},
		{
			"share": 0.0008486594914362654,
			"domain": "buzzfeed.com"
		},
		{
			"share": 0.0008455246362107914,
			"domain": "zwiiky.com"
		},
		{
			"share": 0.0008308691741308513,
			"domain": "whatreallyhappened.com"
		},
		{
			"share": 0.0008299940216238893,
			"domain": "pantip.com"
		},
		{
			"share": 0.0008289704169757159,
			"domain": "ahmnpage.com"
		},
		{
			"share": 0.0008265128430139572,
			"domain": "my.myway.com"
		},
		{
			"share": 0.000826501547859418,
			"domain": "en.hao123.com"
		},
		{
			"share": 0.0008136659242187211,
			"domain": "realcleartechnology.com"
		},
		{
			"share": 0.000806937666328856,
			"domain": "dailyjobcuts.com"
		},
		{
			"share": 0.0007995399221638603,
			"domain": "truth-out.org"
		},
		{
			"share": 0.000792239274854097,
			"domain": "city-data.com"
		},
		{
			"share": 0.0007838124954284004,
			"domain": "centurylink.net"
		},
		{
			"share": 0.0007612335346547432,
			"domain": "casair.net"
		},
		{
			"share": 0.0007606259346770438,
			"domain": "bbc.co.uk"
		},
		{
			"share": 0.0007526962747386948,
			"domain": "fivethirtyeight.com"
		},
		{
			"share": 0.0007467511076463074,
			"domain": "gazeteler.com"
		},
		{
			"share": 0.0007368113934097664,
			"domain": "el.com"
		},
		{
			"share": 0.0007299753991955013,
			"domain": "marklevinshow.com"
		},
		{
			"share": 0.0007210632190889463,
			"domain": "theskimm.com"
		},
		{
			"share": 0.0007208017692031315,
			"domain": "jimmyr.com"
		},
		{
			"share": 0.0007110068668113006,
			"domain": "myoneclick.com"
		},
		{
			"share": 0.0007105578150936461,
			"domain": "hlntv.com"
		},
		{
			"share": 0.0007082041443885609,
			"domain": "start.centurylink.net"
		},
		{
			"share": 0.000704422571486283,
			"domain": "www2.smartbrief.com"
		},
		{
			"share": 0.000703280026733019,
			"domain": "theconservativetreehouse.com"
		},
		{
			"share": 0.0007008693742190461,
			"domain": "search.whiteskyservices.com"
		},
		{
			"share": 0.0006996785855012005,
			"domain": "home.mywebsearch.com"
		},
		{
			"share": 0.0006981840263288677,
			"domain": "bourque.org"
		},
		{
			"share": 0.0006940209692641784,
			"domain": "lifehacker.com"
		},
		{
			"share": 0.0006939995131229515,
			"domain": "spiegel.de"
		},
		{
			"share": 0.0006915659738469842,
			"domain": "ft.com"
		},
		{
			"share": 0.0006873822392666318,
			"domain": "wykop.pl"
		},
		{
			"share": 0.0006789816061221332,
			"domain": "mya2zurls.com"
		},
		{
			"share": 0.0006781037299775674,
			"domain": "aldaily.com"
		},
		{
			"share": 0.0006740137139471902,
			"domain": "stocktwits.com"
		},
		{
			"share": 0.0006731129101405172,
			"domain": "fatwallet.com"
		},
        
		{
			"share": 0.0006720696793546867,
			"domain": "home.windstream.net"
		},
		{
			"share": 0.0006706904482525146,
			"domain": "watch.org"
		},
		{
			"share": 0.0006635292244648367,
			"domain": "boards.endoftheinter.net"
		},
		{
			"share": 0.0006612967206778485,
			"domain": "calcalist.co.il"
		},
		{
			"share": 0.0006504592186865151,
			"domain": "searchdesk.com"
		},
		{
			"share": 0.0006501500170309077,
			"domain": "qz.com"
		},
		{
			"share": 0.0006242047136518017,
			"domain": "news.nettop20.com"
		},
		{
			"share": 0.0006112767367585646,
			"domain": "inoreader.com"
		},
		{
			"share": 0.0006103147507755911,
			"domain": "roomy-tv.com"
		},
		{
			"share": 0.0006081309984002932,
			"domain": "ajc.com"
		},
		{
			"share": 0.0006045631945926289,
			"domain": "mmirtw.com"
		},
		{
			"share": 0.0005994762994426061,
			"domain": "abc.net.au"
		},
		{
			"share": 0.0005967296775895231,
			"domain": "fiostrending.verizon.com"
		},
		{
			"share": 0.0005786744124533436,
			"domain": "omni.se"
		},
		{
			"share": 0.0005743583503321463,
			"domain": "indexuae.com"
		},
		{
			"share": 0.0005712498289049032,
			"domain": "hk.apple.nextmedia.com"
		},
		{
			"share": 0.000567699585166249,
			"domain": "insideautomotive.com"
		},
		{
			"share": 0.0005652592253694862,
			"domain": "mys.yoursearch.me"
		},
		{
			"share": 0.0005531525698003242,
			"domain": "kafe.co.il"
		},
		{
			"share": 0.0005525785911570703,
			"domain": "tvtropes.org"
		},
		{
			"share": 0.0005515123564240136,
			"domain": "startsiden.no"
		},
		{
			"share": 0.0005470179366081923,
			"domain": "8ch.net"
		},
		{
			"share": 0.0005415148441341054,
			"domain": "bustle.com"
		},
		{
			"share": 0.0005386694927429749,
			"domain": "emergencyemail.org"
		},
		{
			"share": 0.0005377505988162832,
			"domain": "mysearch.avg.com"
		},
		{
			"share": 0.000535166729412563,
			"domain": "nakedcapitalism.com"
		},
		{
			"share": 0.0005323515395965024,
			"domain": "espn.go.com"
		},
		{
			"share": 0.0005295221815323172,
			"domain": "kirivong.com"
		},
		{
			"share": 0.0005292581665643067,
			"domain": "hardocp.com"
		},
		{
			"share": 0.0005285320001507205,
			"domain": "freewebs.com"
		},
		{
			"share": 0.0005277190972820012,
			"domain": "hvg.hu"
		},
		{
			"share": 0.0005266046178715766,
			"domain": "arstechnica.com"
		},
		{
			"share": 0.0005225416636189336,
			"domain": "lib.utexas.edu"
		},
		{
			"share": 0.0005124431386796148,
			"domain": "mybroadband.co.za"
		},
		{
			"share": 0.000512118815726605,
			"domain": "www6.nhk.or.jp"
		},
		{
			"share": 0.0005096394003197007,
			"domain": "startpage.co.kr"
		},
		{
			"share": 0.0005079428364767822,
			"domain": "martyelder.coffeecup.com"
		},
		{
			"share": 0.000507739047157867,
			"domain": "abovetopsecret.com"
		},
		{
			"share": 0.0005024098022819531,
			"domain": "jezebel.com"
		},
		{
			"share": 0.0004994283617954108,
			"domain": "theverge.com"
		},
		{
			"share": 0.0004967371370204678,
			"domain": "crickler.com"
		},
		{
			"share": 0.0004964292919043085,
			"domain": "alltop.com"
		},
		{
			"share": 0.0004935115711956596,
			"domain": "darkside.thrillnetwork.net"
		},
		{
			"share": 0.0004919593774950823,
			"domain": "home.nzcity.co.nz"
		},
		{
			"share": 0.0004916258428873733,
			"domain": "motherjones.com"
		},
		{
			"share": 0.000489935886371227,
			"domain": "mitbbs.com"
		},
		{
			"share": 0.0004890617120703025,
			"domain": "politico.com"
		},
		{
			"share": 0.00048383487372123495,
			"domain": "entretenedores.co"
		},
		{
			"share": 0.0004834309407347753,
			"domain": "soccersuck.com"
		},
		{
			"share": 0.00047718400346200864,
			"domain": "indian-panorama.blogspot.in"
		},
		{
			"share": 0.00047499302869338995,
			"domain": "atlasobscura.com"
		},
		{
			"share": 0.000474668849011253,
			"domain": "mentalfloss.com"
		},
		{
			"share": 0.0004730244357042598,
			"domain": "mweb.co.za"
		},
		{
			"share": 0.00046811472749649864,
			"domain": "patheos.com"
		},
		{
			"share": 0.0004656308401571096,
			"domain": "paper.li"
		},
		{
			"share": 0.0004624378503673786,
			"domain": "metafilter.com"
		},
		{
			"share": 0.0004605361303480136,
			"domain": "vice.com"
		},
		{
			"share": 0.0004604207770360611,
			"domain": "forums.hardwarezone.com.sg"
		},
		{
			"share": 0.00045803034712276906,
			"domain": "filter.vail.k12.az.us"
		},
		{
			"share": 0.00045676012557761527,
			"domain": "tbn17.com"
		},
		{
			"share": 0.00045615867047135104,
			"domain": "gizmodo.jp"
		},
		{
			"share": 0.0004544152871940297,
			"domain": "geocities.jp"
		},
		{
			"share": 0.0004542108944157706,
			"domain": "therealtruthabouthealth.com"
		},
		{
			"share": 0.00045138110080148196,
			"domain": "stevequayle.com"
		},
		{
			"share": 0.00044604601063876343,
			"domain": "qkankan.com"
		},
		{
			"share": 0.0004445605086963124,
			"domain": "finviz.com"
		},
		{
			"share": 0.0004443994943022838,
			"domain": "dr-piliulkin.livejournal.com"
		},
		{
			"share": 0.0004424487281255257,
			"domain": "thebiglead.com"
		},
		{
			"share": 0.00044159393801426375,
			"domain": "bluesnews.com"
		},
		{
			"share": 0.0004401167876484516,
			"domain": "search.mpc.am"
		},
		{
			"share": 0.0004391592163640848,
			"domain": "antiwar.com"
		},
		{
			"share": 0.0004386769521739197,
			"domain": "cox.com"
		},
		{
			"share": 0.00043867695217391967,
			"domain": "portal.tranquility.net"
		},
		{
			"share": 0.0004380116882299296,
			"domain": "newzjunky.com"
		},
		{
			"share": 0.0004367684747422084,
			"domain": "thehill.com"
		},
		{
			"share": 0.00043660337414368574,
			"domain": "psych.umn.edu"
		},
		{
			"share": 0.0004363877823375184,
			"domain": "amazon.com"
		},
        {
			"share": 0.00006773688232097288,
			"domain": "crunchyroll.com"
		},
		{
			"share": 0.00006773688232097288,
			"domain": "captainokane.weebly.com"
		},
		{
			"share": 0.00006773688232097288,
			"domain": "subguns.com"
		},
		{
			"share": 0.00006773688232097288,
			"domain": "jtlearn.jths.org"
		}
	]
}

}