API SEO de MetricSpot

Transcripción

1 INTRODUCCIÓN El objetivo de este documento es servir de guía rápida de la interfaz de servicios disponibles en la. Estos mismos servicios son los que utiliza la aplicación de MetricSpot para la generación de informes Web y exportación de los mismos a PDF. La versión actual de la API SEO es la 2.0, quedando la 1.0 todavía en servicio pero sin mantenimiento ni actualizaciones. INVOCACIÓN DE LOS SERVICIOS Y AUTENTICACIÓN Todos los servicios se invocan utilizando el método PUT. Es necesario pasar los parámetros url y apikey con cada llamada. Los parámetros se envían en formato JSON en el BODY (Request Payload) de la llamada. "url": " "apikey": "50feb7ffddd113ed680af020" El parámetro apikey es un número hexadecimal de 24 caracteres y corresponde con tu ID de usuario de MetricSpot. El parámetro url corresponde a la URL que se quiere analizar. Puede enviarse con o sin el prefijo HTTP/HTTPS. Las siguientes URLs son válidas como valor del parámetro url : mailchimp.com

2 CROSS-SITE SCRIPTING Todos los servicios permiten el Cross Origin Resource Sharing (CORS) ya que cuentan con la cabecera HEADER "Access Control Allow Origin: *". Esto permite que, además de poder realizarse desde tu servidor, las llamadas puedan delegarse al cliente realizándose vía AJAX. LÍMITES Y TARIFICACIÓN La dispone de un límite de cortesía de 100 llamadas por usuario. La cuenta Partner permite realizar hasta llamadas mensuales a la API. Una vez sobrepasado este límite, se facturará el equivalente a la cuota mensual de la cuenta Partner y se aumentará el límite en otras llamadas, y así sucesivamente en tramos de llamadas. No existe un límite diario de llamadas, aunque se podrán tomar medidas para evitar sobrecarga del servidor si el número de llamadas por minuto desde una Web pudiese comprometer la estabilidad de la API.

3 Análisis On-Page Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "target": " "website": " "type": "text/html", "charset": "UTF 8", "protocol": "HTTP", "title": "Web Analytics and SEO Tools MetricSpot", "description": "Generate Web analysis & optimization reports and measure more than 50 metrics that influence your ranking in search engines.", "descriptioncount": 1, "robots": [ "INDEX", "FOLLOW", "NOODP", "NOYDIR" ], "keywords": false, "images": [ "src": " "title": "Logo MetricSpot", "alt": "Logo MetricSpot" "src": " icon.png", "title": "Log in with Google", "alt": "Log in with Google"

4 "src": " icon.png", "title": "Log in with Facebook", "alt": "Log in with Facebook" ], "links": "external": [ "href": " "anchor": "Tweet", "title": false, "href": " "anchor": "(img)", "title": false, "rel": "external nofollow" "href": " "anchor": "(img)", "title": false, "rel": "external nofollow" "href": " "anchor": "(img)", "title": false, "rel": "author" "href": " "anchor": "(img)", "title": false, "rel": "external nofollow"

5 "href": " "anchor": "(img)", "title": false, "rel": "external nofollow" ], "internal": [ "href": " "anchor": "(img)", "title": "Web Analysis and SEO Audit Tools", "href": " "anchor": "Log In", "title": "Log In", "href": " "anchor": "Español", "title": "Español", "href": " "anchor": "English", "title": "English", "href": " "anchor": "Web & TwitterAnalysis", "title": "Web & Twitter Analysis", "href": " "anchor": "White LabelPDF Reports",

6 "title": "PDF Reports", "href": " "anchor": "SEOCrawler", "title": "SEO Crawler", "href": " "anchor": "TwitterInfluencers", "title": "Twitter Influencers", "href": " "anchor": "DevelopersAPI", "title": "Developers API", "href": " css/", "anchor": "CSSCompressor", "title": "CSS Compressor", "href": " "anchor": "Log in with Google", "title": "Log in with Google", "href": " "anchor": "Log in with Facebook", "title": "Log in with Facebook",

7 "href": " "anchor": "SEO Crawler (Beta) A thorough crawl of your Website that analyzes page by page the most important factors that affect your SEO rankings.", "title": "SEO Crawler", "href": " web/", "anchor": "Web Performance A guide with all the optimizations that will help you increase your Website's loading speed and improve its user experience.", "title": "Web Performance", "href": " "anchor": "Twitter Influencers Our tool allows you to search for Twitter profiles, find the most influential ones in your market niche and connect with them.", "title": "Twitter Influencers", "href": " "anchor": "Marketing Hacks Do you want to be a top notch Marketeer? Folow our Blog to get access to the best Online Marketing hacks, tools and manuals.", "title": "Marketing Hacks", "href": " account/", "anchor": "Premium users", "title": "Go Awesome", "href": " "anchor": "Web & Twitter Analysis", "title": "Web & Twitter Analysis",

8 "href": " "anchor": "PDF Reports", "title": "PDF Reports", "href": " "anchor": "SEO Crawler", "title": "SEO Crawler", "href": " "anchor": "Twitter Influencers", "title": "Twitter Influencers", "href": " "anchor": "Developers API", "title": "Developers API", "href": " css/", "anchor": "CSS Compressor", "title": "CSS Compressor", "href": " account/", "anchor": "Sign Up", "title": "Sign Up", "href": " "anchor": "Log In", "title": "Log In",

9 "href": " "anchor": "FAQs", "title": "FAQs", "href": " "anchor": "Contact", "title": "Contact", "href": " "anchor": "Newsletter", "title": "Newsletter", "href": " "anchor": "Sponsors", "title": "Sponsors", "href": " "anchor": "Affiliates", "title": "Affiliates", "rel": "nofollow" "href": " de uso/", "anchor": "Terms of Service", "title": "Terms of Service", "rel": "nofollow" "href": " "anchor": "Online Marketing Hacks",

10 "title": "Online Marketing Hacks", "href": " trucos content marketing/", "anchor": "10 Trucos de Content Marketing", "title": "10 Trucos de Content Marketing", "href": " crawler seo online/", "anchor": "Nuevo Crawler SEO Online", "title": "Nuevo Crawler SEO Online", "href": " plugins esenciales wordpress/", "anchor": "20 Plugins Esenciales para WordPress", "title": "20 Plugins Esenciales para WordPress", "href": " seo wordpress/", "anchor": "Trucos SEO para WordPress", "title": "Trucos SEO para WordPress", ] "headers": "h1": [ "Web Analytics and SEO Tools" ], "h2": [ "Analyze a Website or a Twitter account:" ], "h345": [ "SEO Crawler (Beta)", "Web Performance", "Twitter Influencers",

11 "Marketing Hacks", "Get access to our best SEO hacks" ] "highlights": "b": [ "85% of our best SEO hacks and tools" ], "u": false, "i": false "blog": true, "cleanurls": true, "favicon": " "googlefavicon": " "printcss": true, "language": "EN", "convform": true, "pagespeed": "pagesize": 18.61, "downspeed": 24.3, "downtime": 0.77 "metatags": "DESCRIPTION": "Generate Web analysis & optimization reports and measure more than 50 metrics that influence your ranking in search engines.", "AUTHOR": "MetricSpot", "VIEWPORT": "width=device width, initial scale=1, user scalable=yes", "ROBOTS": "index, follow, noodp, noydir", "OG:URL": " "OG:TITLE": "Web Analytics and SEO Tools", "OG:SITE_NAME": "MetricSpot", "OG:DESCRIPTION": "Generate Web analysis & optimization reports and measure more than 50 metrics that influence your ranking in search engines.", "OG:IMAGE": " og.png", "OG:TYPE": "website", "OG:LOCALE": "en_us", "FB:APP_ID": " ", "FB:ADMINS": " "

12 "texthtmlratio": 35.97, " privacy": true, "analytics": false, "weboptimization": "notables": true, "noframes": true, "noinline": true, "numcss": 1, "numjs": 9 "webtech": "ganalytics": false, "flavors": false, "flash": false, "angularjs": false, "jquery": true, "gfonts": true, "gmaps": false, "fontawesome": false, "bootstrap": false, "fbapi": true, "fblike": true, "twbutton": true, "gplusone": true, "sharethis": false, "sumome": false, "rssfeed": false, "wordpress": false, "joomla": false, "drupal": false, "codeigniter": true, "blogger": false, "concrete5": false, "prestashop": false, "oscommerce": false, "wpcommerce": false, "magento": false, "woocommerce": false, "mediawiki": false, "server": "nginx"

13 "ip": " ", "social": "fbaccount": [ "metricspot" ], "twaccount": [ "metricspot" ], "metadata": "og:title": "Web Analytics and SEO Tools", "og:description": "Generate Web analysis & optimization reports and measure more than 50 metrics that influence your ranking in search engines.", "og:url": " "og:image": " og.png", "twitter:title": false, "twitter:description": false, "twitter:url": false, "twitter:image": false, "twitter:site": false, "twitter:creator": false

14 Autoridad del Dominio Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "hostname": "metricspot.com", "pagerank": 3, "alexa": "rank": 36452, "country": "ES", "countryrank": 1726, "backlinks": 251, "dmoz": false "whois": "creationtime": , "expirationtime":

15 Datos de Tráfico (Alexa Web Information Services) Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "contactinfo": "owner": false, "phone": false, " ": false, "street": false, "city": false, "zipcode": false, "state": false, "country": false "contentdata": "loadtime": 2251, "speedpercentile": 29, "linksincount": 251 "trafficdata": "rank": 36452, "countries": [ "code": "IN", "rank": , "pageviews": 1.4, "users": 1.8

16 "code": "ES", "rank": 1726, "pageviews": 42, "users": 45.5 "code": "CL", "rank": 3156, "pageviews": 4.1, "users": 2.7 "code": "AR", "rank": 9279, "pageviews": 2.3, "users": 2.6 "code": "CO", "rank": 6946, "pageviews": 1.6, "users": 2.2 "code": "MX", "rank": 1924, "pageviews": 32.6, "users": 29.4 "code": "O", "rank": false, "pageviews": 12.1, "users": 10.7 "code": "PE", "rank": 2118, "pageviews": 3.9, "users": 5.1

17 ], "cities": [ "name": "Mexico City", "rank": 1703, "pageviews": 9.5, "users": 10.7, "country": "MX", "code": "C13" "name": "Guadalajara", "rank": 327, "pageviews": 9.7, "users": 7.8, "country": "MX", "code": "C65" "name": "Barcelona", "rank": 1349, "pageviews": 7.6, "users": 6.1, "country": "ES", "code": "C94" "name": "Valencia", "rank": 933, "pageviews": 3.2, "users": 5.3, "country": "ES", "code": "C223" "name": "Lugo", "rank": 178, "pageviews": 1.7, "users": 4,

18 "country": "ES", "code": "C2494" "name": "Madrid", "rank": 3695, "pageviews": 2.9, "users": 3.8, "country": "ES", "code": "C39" "name": "Lima", "rank": 2297, "pageviews": 2.8, "users": 3.6, "country": "PE", "code": "C14" "name": "Ovalle", "rank": 25, "pageviews": 1.1, "users": 1.7, "country": "CL", "code": "C781" "name": "Santiago", "rank": 3350, "pageviews": 3.6, "users": 1.6, "country": "CL", "code": "C4" "name": "Sevilla", "rank": 1398, "pageviews": 2.3, "users": 1.5,

19 "country": "ES", "code": "C358" "name": "Arnedo", "rank": 16, "pageviews": 0.5, "users": 1.2, "country": "ES", "code": "C12387" "name": "Granada", "rank": 996, "pageviews": 2, "users": 1.2, "country": "ES", "code": "C714" "name": "Bogotá", "rank": 6778, "pageviews": 0.7, "users": 0.9, "country": "CO", "code": "C134984" "name": "Algeciras", "rank": 281, "pageviews": 0.7, "users": 0.9, "country": "ES", "code": "C2672" "name": "Lorca", "rank": 119, "pageviews": 1.4, "users": 0.8,

20 "country": "ES", "code": "C5798" "name": "Bilbao", "rank": 1566, "pageviews": 0.9, "users": 0.8, "country": "ES", "code": "C802" "name": "Zaragoza", "rank": 2704, "pageviews": 0.6, "users": 0.7, "country": "ES", "code": "C443" "name": "OTHER", "rank": false, "pageviews": 48.9, "users": 47.3, "country": false, "code": "O" ], "statistics": [ "timerange": 90, "rank": 36452, "delta": "timerange": 30, "rank": 37716, "delta": 4859

21 "timerange": 7, "rank": 38382, "delta": 5008 "timerange": 1, "rank": 24956, "delta": ], "subdomains": [ "trafficpercentage": 100, "pageviewsperuser": 3.1, "subdomain": "metricspot.com" ]

22 Robots.txt Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "robots": true El parámetro robots será true si se detecta el fichero robots.txt

23 Sitemap.xml Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "sitemap": true El parámetro sitemap será true si se detecta un sitemap.xml o un índice de sitemaps.

24 Redirección WWW Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "wwwredirect": true El parámetro wwwredirect será true si la Web con WWW y sin WWW redirigen a la misma URL y el contenido es el mismo.

25 Optimización de WordPress Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": "yoast.com", "wordpress": "version": "4.1", "yoast": "1.7.1", "noscripts": false, "nofolders": false, "securelogin": true, "noadmin": true, "latestwordpress": "4.1", "latestyoast": "1.7.1"

26 Optimización para Móviles Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": "yoast.com", "mobile": "css": true, "viewport": true, "appleicon": true, "noflash": true, "noredirect": true, "responsive": true

27 Validación W3C Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "code": 301, "website": "yoast.com", "w3c": 2 Si hay errores de validación, el parámetro w3c devuelve el número de errores. En caso de que no haya errores, el parámetro w3c será true.

28 Página de Error 404 Personalizada Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "custom404": true El parámetro custom404 será true si se detecta una página de error 404 personalizada.

29 Favicon Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "favicon": " Si el icon existe, el parámetro favicon será un string con la URL del mismo o false en caso contrario.

30 Formulario de Conversión Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "convform": true Este servicio debe invocarse sólo si no se ha detectado un formulario de conversión en la llamada de Análisis On Page. Si la Web tiene un formulario de conversión en la página de inicio o en la página de contacto, el parámetro convform será true.

31 Google Analytics Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "analytics": true Este servicio debe invocarse sólo si no se ha detectado Google Analytics en la llamada de Análisis On Page. El parámetro analytics será true si se detecta el código de seguimiento de Google Analytics en el HTML de la Web o en alguno de los Scripts cargados.

32 Influencia Social de la Web Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "social": "fblikes": 131, "fbshares": 169, "fbcomments": 25, "twbacklinks": 318, "gplusones": 453, "linkedin": 46, "stumbleupon": 8, "pinterest": 0

33 Datos de la cuenta de Facebook Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "facebook": "name": "metricspot", "image": " "title": "MetricSpot", "website": " "about": "Creamos herramientas para SEO, Social Media y Web Performance", "friends": 2367, "talking": 4 Este servicio detecta las cuentas de Facebook enlazadas desde la Web y extrae los datos de Facebook Open Graph.

34 Datos de la cuenta de Twitter Endpoint: [PUT] Ejemplo de respuesta: "data": "url": " "checktime": , "website": " "twitter": "user": "MetricSpot", "title": "MetricSpot", "bio": "Creamos herramientas para SEO, Social Media y Web Performance", "followers": 668, "website": " "location": "Madrid Barcelona", "tweets": 346, "image": " Este servicio detecta las cuentas de Twitter enlazadas desde la Web y extrae los datos de la API de Twitter.