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": "www.metricspot.com", "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 www.metricspot.com http://www.metricspot.com https://yoast.com
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 30.000 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 30.000 llamadas, y así sucesivamente en tramos de 30.000 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.
Análisis On-Page Endpoint: [PUT] http://www.metricspot.com/api/v2/audit Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420750191, "target": "http://www.metricspot.com", "website": "www.metricspot.com", "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": "http://www.metricspot.com/img/metricspot.png", "title": "Logo MetricSpot", "alt": "Logo MetricSpot" "src": "http://www.metricspot.com/img/home/google icon.png", "title": "Log in with Google", "alt": "Log in with Google"
"src": "http://www.metricspot.com/img/home/facebook icon.png", "title": "Log in with Facebook", "alt": "Log in with Facebook" ], "links": "external": [ "href": "https://twitter.com/share", "anchor": "Tweet", "title": false, "href": "http://www.facebook.com/metricspot", "anchor": "(img)", "title": false, "rel": "external nofollow" "href": "https://twitter.com/metricspot", "anchor": "(img)", "title": false, "rel": "external nofollow" "href": "https://plus.google.com/+metricspot", "anchor": "(img)", "title": false, "rel": "author" "href": "http://feeds.feedburner.com/metricspot?format=xml", "anchor": "(img)", "title": false, "rel": "external nofollow"
"href": "http://eepurl.com/nyksz", "anchor": "(img)", "title": false, "rel": "external nofollow" ], "internal": [ "href": "http://www.metricspot.com/", "anchor": "(img)", "title": "Web Analysis and SEO Audit Tools", "href": "http://www.metricspot.com/login/", "anchor": "Log In", "title": "Log In", "href": "http://www.metricspot.com/es/", "anchor": "Español", "title": "Español", "href": "http://www.metricspot.com/en/", "anchor": "English", "title": "English", "href": "http://www.metricspot.com/", "anchor": "Web & TwitterAnalysis", "title": "Web & Twitter Analysis", "href": "http://www.metricspot.com/pdf/", "anchor": "White LabelPDF Reports",
"title": "PDF Reports", "href": "http://www.metricspot.com/crawler/", "anchor": "SEOCrawler", "title": "SEO Crawler", "href": "http://www.metricspot.com/influencers/", "anchor": "TwitterInfluencers", "title": "Twitter Influencers", "href": "http://www.metricspot.com/api/", "anchor": "DevelopersAPI", "title": "Developers API", "href": "http://www.metricspot.com/minify css/", "anchor": "CSSCompressor", "title": "CSS Compressor", "href": "http://www.metricspot.com/openid/", "anchor": "Log in with Google", "title": "Log in with Google", "href": "http://www.metricspot.com/fblogin/", "anchor": "Log in with Facebook", "title": "Log in with Facebook",
"href": "http://www.metricspot.com/crawler/", "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": "http://www.metricspot.com/rendimiento 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": "http://www.metricspot.com/influencers/", "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": "http://www.metricspot.com/blog/", "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": "http://www.metricspot.com/create account/", "anchor": "Premium users", "title": "Go Awesome", "href": "http://www.metricspot.com/", "anchor": "Web & Twitter Analysis", "title": "Web & Twitter Analysis",
"href": "http://www.metricspot.com/pdf/", "anchor": "PDF Reports", "title": "PDF Reports", "href": "http://www.metricspot.com/crawler/", "anchor": "SEO Crawler", "title": "SEO Crawler", "href": "http://www.metricspot.com/influencers/", "anchor": "Twitter Influencers", "title": "Twitter Influencers", "href": "http://www.metricspot.com/api/", "anchor": "Developers API", "title": "Developers API", "href": "http://www.metricspot.com/minify css/", "anchor": "CSS Compressor", "title": "CSS Compressor", "href": "http://www.metricspot.com/create account/", "anchor": "Sign Up", "title": "Sign Up", "href": "http://www.metricspot.com/login/", "anchor": "Log In", "title": "Log In",
"href": "http://www.metricspot.com/faqs/", "anchor": "FAQs", "title": "FAQs", "href": "http://www.metricspot.com/contact/", "anchor": "Contact", "title": "Contact", "href": "http://www.metricspot.com/newsletter/", "anchor": "Newsletter", "title": "Newsletter", "href": "http://www.metricspot.com/sponsors/", "anchor": "Sponsors", "title": "Sponsors", "href": "http://www.metricspot.com/affiliates/", "anchor": "Affiliates", "title": "Affiliates", "rel": "nofollow" "href": "http://www.metricspot.com/condiciones de uso/", "anchor": "Terms of Service", "title": "Terms of Service", "rel": "nofollow" "href": "http://www.metricspot.com/blog/", "anchor": "Online Marketing Hacks",
"title": "Online Marketing Hacks", "href": "http://www.metricspot.com/blog/10 trucos content marketing/", "anchor": "10 Trucos de Content Marketing", "title": "10 Trucos de Content Marketing", "href": "http://www.metricspot.com/blog/nuevo crawler seo online/", "anchor": "Nuevo Crawler SEO Online", "title": "Nuevo Crawler SEO Online", "href": "http://www.metricspot.com/blog/20 plugins esenciales wordpress/", "anchor": "20 Plugins Esenciales para WordPress", "title": "20 Plugins Esenciales para WordPress", "href": "http://www.metricspot.com/blog/trucos 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",
"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": "http://www.metricspot.com/favicon.ico", "googlefavicon": "http://www.google.com/s2/favicons?domain=www.metricspot.com", "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": "http://www.metricspot.com", "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": "http://www.metricspot.com/img/insert/fb og.png", "OG:TYPE": "website", "OG:LOCALE": "en_us", "FB:APP_ID": "677351958941488", "FB:ADMINS": "1193701445"
"texthtmlratio": 35.97, "emailprivacy": 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"
"ip": "75.126.24.81", "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": "http://www.metricspot.com", "og:image": "http://www.metricspot.com/img/insert/fb og.png", "twitter:title": false, "twitter:description": false, "twitter:url": false, "twitter:image": false, "twitter:site": false, "twitter:creator": false
Autoridad del Dominio Endpoint: [PUT] http://www.metricspot.com/api/v2/domain Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420752843, "website": "www.metricspot.com", "hostname": "metricspot.com", "pagerank": 3, "alexa": "rank": 36452, "country": "ES", "countryrank": 1726, "backlinks": 251, "dmoz": false "whois": "creationtime": 1356187403, "expirationtime": 1513953803
Datos de Tráfico (Alexa Web Information Services) Endpoint: [PUT] http://www.metricspot.com/api/v2/awis Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420753093, "website": "www.metricspot.com", "contactinfo": "owner": false, "phone": false, "email": 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": 150939, "pageviews": 1.4, "users": 1.8
"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
], "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,
"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,
"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,
"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": 17696 "timerange": 30, "rank": 37716, "delta": 4859
"timerange": 7, "rank": 38382, "delta": 5008 "timerange": 1, "rank": 24956, "delta": 49293 ], "subdomains": [ "trafficpercentage": 100, "pageviewsperuser": 3.1, "subdomain": "metricspot.com" ]
Robots.txt Endpoint: [PUT] http://www.metricspot.com/api/v2/robots Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420752593, "website": "www.metricspot.com", "robots": true El parámetro robots será true si se detecta el fichero robots.txt
Sitemap.xml Endpoint: [PUT] http://www.metricspot.com/api/v2/sitemap Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420752593, "website": "www.metricspot.com", "sitemap": true El parámetro sitemap será true si se detecta un sitemap.xml o un índice de sitemaps.
Redirección WWW Endpoint: [PUT] http://www.metricspot.com/api/v2/wwwredirect Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420752593, "website": "www.metricspot.com", "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.
Optimización de WordPress Endpoint: [PUT] http://www.metricspot.com/api/v2/wordpress Ejemplo de respuesta: "data": "url": "https://yoast.com/", "checktime": 1420751973, "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"
Optimización para Móviles Endpoint: [PUT] http://www.metricspot.com/api/v2/mobile Ejemplo de respuesta: "data": "url": "https://yoast.com/", "checktime": 1420752070, "website": "yoast.com", "mobile": "css": true, "viewport": true, "appleicon": true, "noflash": true, "noredirect": true, "responsive": true
Validación W3C Endpoint: [PUT] http://www.metricspot.com/api/v2/w3c Ejemplo de respuesta: "data": "url": "https://yoast.com/", "checktime": 1420752177, "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.
Página de Error 404 Personalizada Endpoint: [PUT] http://www.metricspot.com/api/v2/custom404 Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420752434, "website": "www.metricspot.com", "custom404": true El parámetro custom404 será true si se detecta una página de error 404 personalizada.
Favicon Endpoint: [PUT] http://www.metricspot.com/api/v2/favicon Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420753349, "website": "www.metricspot.com", "favicon": "http://www.metricspot.com/favicon.ico" Si el icon existe, el parámetro favicon será un string con la URL del mismo o false en caso contrario.
Formulario de Conversión Endpoint: [PUT] http://www.metricspot.com/api/v2/convform Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420753503, "website": "www.metricspot.com", "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.
Google Analytics Endpoint: [PUT] http://www.metricspot.com/api/v2/analytics Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420753632, "website": "www.metricspot.com", "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.
Influencia Social de la Web Endpoint: [PUT] http://www.metricspot.com/api/v2/social Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420751838, "website": "www.metricspot.com", "social": "fblikes": 131, "fbshares": 169, "fbcomments": 25, "twbacklinks": 318, "gplusones": 453, "linkedin": 46, "stumbleupon": 8, "pinterest": 0
Datos de la cuenta de Facebook Endpoint: [PUT] http://www.metricspot.com/api/v2/facebook Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420753927, "website": "www.metricspot.com", "facebook": "name": "metricspot", "image": "http://www.metricspot.com/img/uploads/metricspot.png", "title": "MetricSpot", "website": "www.metricspot.com", "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.
Datos de la cuenta de Twitter Endpoint: [PUT] http://www.metricspot.com/api/v2/twitter Ejemplo de respuesta: "data": "url": "http://www.metricspot.com", "checktime": 1420754105, "website": "www.metricspot.com", "twitter": "user": "MetricSpot", "title": "MetricSpot", "bio": "Creamos herramientas para SEO, Social Media y Web Performance", "followers": 668, "website": "www.metricspot.com", "location": "Madrid Barcelona", "tweets": 346, "image": "http://pbs.twimg.com/profile_images/473059857684123648/h_ewxwz1_normal.png" Este servicio detecta las cuentas de Twitter enlazadas desde la Web y extrae los datos de la API de Twitter.