#4 : Output and Result

SEMANTIC SEARCH

RESULT  

Output in application/JSON (raw) 

 

RESPONSE BODY

RESULT		DESCRIPTION
urls, score		URLs that are similar to the provided content. The score reflects the similarity of the URLs content to the provided search input. As higher the score as more similarity, the URL has to your input.
tlds, count		Top Level Domains (tld) that contain URLs that similar to the provided content and the frequency number of matching URLs
keywords, count		Normalized keywords that appear in content similar to the provided content.

SIMPLE SEARCH (FULL-TEXT SEARCH)

RESPONSE 

Output in application/JSON (raw) 

 

RESPONSE BODY

RESULT		DESCRIPTION
urls, score		The URLs the surface forms appears on. The score reflects how well the content matches on the URL the provided search input. As higher the score as well the content matches your search query.
tlds, count		Top Level Domains (TLDs) that contain URLs that contain the provided content and the frequency number of matching URLs
keywords, count		Normalized keywords that appear in the content the surface forms appear in.

RESULTS

EXAMPLE - RESULT: "NO DATA YET" (UNKNOWN URL)

Request 

{"url":"http://www.theguardian.com/commentisfree/2018/oct/30/angela-merkel-germany-brexit-uk-eu-cohesion", "maxresults":"10"}

 

Example Result

{
 "status": {
 "type": "No data yet",
 "message": "Analysis in progress",
 "code": 0
 }
}

EXAMPLE - RESULT: "OK"

Request 

{"url":"http://www.theguardian.com/commentisfree/2018/oct/30/angela-merkel-germany-brexit-uk-eu-cohesion", "maxresults":"10"}

 

Example Result

{
 "status": {
 "message": "All seems well.",
 "code": "1",
 "type": "Ok"
 },
 "result": {
 "tld": [
 [
 "uk.yahoo.com", 2
 ],
 [
 "www.irishtimes.com",  2
 ],
 [
 "www.theguardian.com",  2
 ],
 [
 "www.spectator.co.uk",  1
 ],
 [
 "uk.news.yahoo.com",  1
 ],
 [
 "www.dict.cc",  1
 ],
 [
 "watchingamerica.com",  1
 ],
 [
 "www.efe.com",  1
 ],
 [
 "www.politics.co.uk",  1
 ],
 [
 "politics.co.uk",  1
 ],
 [
 "pinkfishmedia.net",  1
 ]
 ],
 "urls": {
 "https://uk.yahoo.com/news/merkel-going-germany-won-t-101244873.html": 157.22086,
 "https://www.irishtimes.com/news/politics/eu-and-british-very-close-to-reaching-deal-on-irish-border-1.3684517": 100.435745,
 "https://www.irishtimes.com/news/world/brexit/eu-and-british-very-close-to-reaching-deal-on-irish-border-1.3684517": 100.32043,
 "https://www.spectator.co.uk/2018/09/a-canada-style-brexit-deal-might-come-back-on-to-the-table/": 96.27327,
 "https://www.theguardian.com/politics/2018/oct/31/why-the-uks-brexit-negotiation-tactics-drew-a-blank": 94.15426,
 "https://www.theguardian.com/commentisfree/2018/oct/30/angela-merkel-germany-brexit-uk-eu-cohesion": 34.420418,
 "https://uk.news.yahoo.com/merkel-going-germany-won-t-101244873.html": 29.153454,
 "https://www.dict.cc/englisch-deutsch/commissioner.html": 26.17506,
 "https://watchingamerica.com/WA/2018/08/24/america-is-a-cartel-paradise-for-real-competition-you-have-to-be-in-the-eu/": 25.386047,
 "https://www.efe.com/efe/english/business/ec-hands-london-an-ultimatum-demanding-3-18-billion-usd-in-custom-duties/50000265-3759744": 24.735209,
 "https://www.politics.co.uk/blogs/2018/11/06/backstop-breakdown-is-a-product-of-the-oldest-brexit-lie": 24.584286,
 "https://politics.co.uk/blogs/2018/11/06/backstop-breakdown-is-a-product-of-the-oldest-brexit-lie": 24.57682,
 "https://uk.yahoo.com/news/brexit-eu-steps-no-deal-172400337.html": 24.571196,
 "https://pinkfishmedia.net/forum/threads/eu-single-market-and-customs-union.221296/page-2": 24.186663
 },
 "keywords": [
 [
 "European Union",  14
 ],
 [
 "United Kingdom",  14
 ],
 [
 "Brexit",  9
 ],
 [
 "European Commission",  7
 ],
 [
 "European Single Market",  6
 ],
 [
 "Germany",  5
 ],
 [
 "Coveney, Cambridgeshire",  3
 ],
 [
 "Customs union",  3
 ],
 [
 "Tanistry",  3
 ],
 [
 "European Union Customs Union",  3
 ],
 [
 "Chequers",  2
 ],
 [
 "Tory",  2
 ],
 [
 "United States",  2
 ],
 [
 "Google",  2
 ],
 [
 "Market power",  2
 ],
 [
 "United Nations",  1
 ],
 [
 "Australia",  1
 ],
 [
 "London",  1
 ],
 [
 "China",  1
 ],
 [
 "European Council",  1
 ],
 [
 "Brussels",  1
 ],
 [
 "Maastricht Treaty",
 1
 ],
 [
 "Plebs",
 1
 ]
 ]
 }
}

EXAMPLE - RESULT: "NOT AUTHORIZED"

Your API-Key is not authorized to access the hyScore search API endpoint. Please contact the support at [e-mail] 

{

    "status": {"type": "Error", "message": "API Key not authorized", "code": 99}