Saltar al contenido Saltar a la navegación

Comience con la API REST de SEOPress

Métodos de autenticación

A través de las cookies de WordPress

Headers para enviar con su solicitud:

  • X-WP-Nonce: abra la consola de su navegador, ingrese «wpApiSettings» y copie el nonce
  • Cookie: abra la consola de su navegador, vaya a Aplicaciones y copie el nombre Y el valor de esta cookie wordpress_logged_in_ (eg: wordpress_logged_in_41432erzre768dffez23456=admin%AREGREJOGRE54Y65KO534KTO4O3TJ43EFFEKZFOEZK£FEZRGTH)

A través de contraseñas de aplicaciones

Se requiere SEOPress 6.8.

Es la mejor solución. Cree una contraseña de aplicación desde su perfil de WordPress.

Use su ID de WP (por ejemplo, admin) y esta nueva contraseña de la aplicación para autenticarse (elija «Basic Authentification» en Postman o equivalente).

Body (JSON Object) para enviar con su solicitud dependiendo del punto final:

Título y meta descripción

{
    "title":"this is SEO title",
    "description":"this is meta description"
}

Palabras clave objetivo

{
    "_seopress_analysis_target_kw":"keyword1, keyword2"
}

Metadatos sociales

{
    "_seopress_social_fb_title":"my facebook title",
    "_seopress_social_fb_desc":"my facebook description",
    "_seopress_social_fb_img":"facebook image URL",
    "_seopress_social_fb_img_attachment_id":"facebook attachment ID",
    "_seopress_social_fb_img_width":"facebook attachment width",
    "_seopress_social_fb_img_height":"facebook attachment height",
    "_seopress_social_twitter_title":"my twitter title",
    "_seopress_social_twitter_desc":"my twitter description",
    "_seopress_social_twitter_img":"twitter image URL",
    "_seopress_social_twitter_img_attachment_id":"twitter attachment ID",
    "_seopress_social_twitter_img_width":"twitter attachment width",
    "_seopress_social_twitter_img_height":"twitter attachment height"
}

Meta robots

{
    "_seopress_robots_index":"yes",
    "_seopress_robots_follow":"yes",
    "_seopress_robots_archive":"yes",
    "_seopress_robots_snippet":"yes",
    "_seopress_robots_imageindex":"yes",
    "_seopress_robots_canonical":"my canonical URL",
    "_seopress_robots_primary_cat":"my primary cat ID",
    "_seopress_robots_breadcrumbs":"my custom breadcrumbs"
}

Redirección

{
    "_seopress_redirections_enabled":"yes",
    "_seopress_redirections_logged_status":"both|only_logged_in|only_not_logged_in",
    "_seopress_redirections_type":"301|302|307",
    "_seopress_redirections_value":"my redirection URL"
}

Respuesta:

Si tiene éxito:

{
    "code": "success"
}

Si falla:

{
    "code": "rest_forbidden",
    "message": "Sorry, you are not allowed to do that.",
    "data": {
        "status": 401
    }
}

o

{
    "code": "rest_cookie_invalid_nonce",
    "message": "Cookie check failed",
    "data": {
        "status": 403
    }
}

Obtener metadatos de publicaciones

Desde SEOPress 5.0, puede solicitar sus metadatos de SEO utilizando nuestra API REST.

Tenga en cuenta que, por razones de seguridad, debe iniciar sesión con un usuario con la capacidad edit_post.

Actualmente hay 2 rutas disponibles:

  • /wp-json/seopress/v1/posts/[postId]: reemplaza [postId] por el ID de tu publicación
  • /wp-json/seopress/v1/posts/by-url?url=https://example.com/seopress-best-wordpress-seo-plugin/ reemplace la URL por el enlace permanente deseado

Método disponible: GET.

Obtendrá en respuesta un JSON con la siguiente información:

{ 
    "title": "SEOPress, Best WordPress SEO plugin", 
    "description": "My super meta description", 
    "canonical": "https://example.com/seopress-best-wordpress-seo-plugin/", 
    "og": { 
        "title": "My Facebook title", 
        "description": "My Facebook description", 
        "image": "https://example.com/seopress-best-wordpress-seo-plugin.jpg",
        "attachment_id": "1",
        "image_width": "1920",
        "image_height": "1080"
    }, 
    "twitter": { 
        "title": "My Twitter title", 
        "description": "My Twitter description", 
        "image": "https://example.com/seopress-best-wordpress-seo-plugin.jpg",
        "attachment_id": "1",
        "image_width": "1920",
        "image_height": "1080"
    },
    "robots": {
        "noindex": false, 
        "nofollow": false, 
        "noarchive": false, 
        "nosnippet": false, 
        "noimageindex": false 
    },
    "primarycat": "1",
    "breadcrumbs": "my custom breadcrumbs for current item",
    "redirections": {
        "enabled": true,
        "status":"both",
        "type":"301",
        "value":"https://example.com/destination-url/"
    }
}

Para solicitar sus datos, puede utilizar, por ejemplo, la API HTTP de WordPress.

Obtener metadatos de términos

Desde SEOPress 5.5, puede obtener metadatos de SEO para sus términos de taxonomía utilizando nuestra API REST.

Tenga en cuenta que, por razones de seguridad, debe iniciar sesión con un usuario con la capacidad edit_post.

Actualmente hay 2 rutas disponibles:

  • /wp-json/seopress/v1/terms/[termId] : reemplace [termId] con su ID de término
  • /wp-json/seopress/v1/terms/[termId]?taxonomy=[yourCustomTaxonomy] similar a la ruta anterior, con taxonomía como argumento (predeterminado: «categoría» si no se proporciona)

Método disponible: GET.

Obtendrá en respuesta un JSON con la siguiente información:

{ 
    "title": "My super term title", 
    "description": "My super term meta description",
    "canonical": "https://example.com/seopress-best-wordpress-seo-plugin/",
    "og": { 
        "title": "My Facebook term title", 
        "description": "My Facebook term description", 
        "image": "https://example.com/term-seopress-best-wordpress-seo-plugin.jpg",
        "attachment_id": "1",
        "image_width": "1920",
        "image_height": "1080" 
    }, 
    "twitter": { 
        "title": "My Twitter term title", 
        "description": "My Twitter term description", 
        "image": "https://example.com/term-seopress-best-wordpress-seo-plugin.jpg",
        "attachment_id": "1",
        "image_width": "1920",
        "image_height": "1080"
    }, 
    "robots": { 
        "noindex": false, 
        "nofollow": false, 
        "noarchive": false, 
        "nosnippet": false, 
        "noimageindex": false 
    },
    "breadcrumbs": "my custom breadcrumbs for current item",
    "redirections": {
        "enabled": true,
        "status":"both",
        "type":"301",
        "value":"https://example.com/destination-url/"
    }
}

Enviar metadatos de publicación

Para escribir metadatos de publicaciones de SEO, puede usar estos puntos finales:

  • título y meta descripción: /wp-json/seopress/v1/posts/[postId]/title-description-metas
  • palabras clave objetivo: /wp-json/seopress/v1/posts/[postId]/target-keywords
  • social meta: /wp-json/seopress/v1/posts/[postId]/social-settings
  • meta robots: /wp-json/seopress/v1/posts/[postId]/meta-robot-settings
  • redirección: /wp-json/seopress/v1/posts/[postId]/redirection-settings

Capacidad de usuario necesaria para la seguridad: edit_post

Método disponible: PUT.

Obtener la configuración de SEOPress

Desde SEOPress 5.5, puede solicitar configuraciones globales de SEOPress a través de nuestra API REST.

Tenga en cuenta que, por razones de seguridad, debe iniciar sesión con un usuario con la capacidad de manage_options.

Actualmente hay 10 rutas disponibles:

  • /wp-json/seopress/v1/options/dashboard-settings: Configuración del panel
  • /wp-json/seopress/v1/options/titles-settings: Títulos y metaconfiguraciones
  • /wp-json/seopress/v1/options/social-settings: Configuración de redes sociales
  • /wp-json/seopress/v1/options/sitemaps-settings: Configuración de mapas de sitio
  • /wp-json/seopress/v1/options/analytics-settings: Ajustes de medición y análisis estadístico
  • /wp-json/seopress/v1/options/advanced-settings: Ajustes avanzados
  • /wp-json/seopress/v1/options/bot-settings: Configuración de bots
  • /wp-json/seopress/v1/options/indexing-settings: Configuración de indexación instantánea
  • /wp-json/seopress/v1/options/license-settings: Configuración de licencia
  • /wp-json/seopress/v1/options/pro-settings: Configuración PRO

Método disponible: GET.

Obtendrá en respuesta un JSON con la siguiente información:

{
  "cards_order": [
    "seopress-page-list",
    "notice-insights-alert",
    "seopress-news-panel"
  ],
  "toggle-rich-snippets": "1",
  "toggle-404": "1",
  "toggle-bot": "1",
  "toggle-titles": "1",
  "toggle-white-label": "0",
  "toggle-social": "1",
  "toggle-xml-sitemap": "1",
  "toggle-google-analytics": "1",
  "toggle-advanced": "1",
  "toggle-woocommerce": "1",
  "toggle-edd": "1",
  "toggle-local-business": "1",
  "toggle-dublin-core": "1",
  "toggle-breadcrumbs": "1",
  "toggle-robots": "1",
  "toggle-news": "1",
  "toggle-rewrite": "1",
  "toggle-instant-indexing": "1",
  "notice-wizard": "1"
}

Obtener informes de publicaciones de Search Console

Desde SEOPress 5.7, puede solicitar informes de Google Search Console de sus publicaciones utilizando nuestra API REST.

Tenga en cuenta que, por razones de seguridad, debe iniciar sesión con un usuario con la capacidad edit_post.

1 ruta está disponible actualmente:

  • /wp-json/seopress/v1/posts/[postID]/inspect : reemplace [postID] con el ID de la publicación

Método disponible: GET.

Obtendrá como respuesta un JSON que contiene la siguiente información:

{
    "google_api_key_is_empty": false,
    "data": {
        "inspectionResult": {
            "inspectionResultLink": "https://search.google.com/search-console/inspect?resource_id=https://example.com/&id=xxxxxxxx&utm_medium=link&utm_source=api",
            "indexStatusResult": {
                "coverageState": "Indexed, not submitted in sitemap",
                "crawledAs": "MOBILE",
                "googleCanonical": "https://example.com/",
                "indexingState": "INDEXING_ALLOWED",
                "lastCrawlTime": "2022-04-29T13:25:27Z",
                "pageFetchState": "SUCCESSFUL",
                "referringUrls": [
                    "https://www.example.com/"
                ],
                "robotsTxtState": "ALLOWED",
                "sitemap": null,
                "userCanonical": "https://example.com/",
                "verdict": "PASS"
            },
            "mobileUsabilityResult": {
                "verdict": "PASS"
            },
            "richResultsResult": {
                "verdict": "PASS",
                "detectedItems": [
                {
                    "richResultType": "Logos",
                    "items": [
                    {
                        "name": "Unnamed item"
                    }
                    ]
                },
                {
                    "richResultType": "Sitelinks searchbox",
                    "items": [
                        {
                            "name": "Unnamed item"
                        }
                        ]
                    }
                ]
            }
        }
    }
}

Obteniendo problemas de SEO

Desde SEOPress 8.2, puede obtener sus problemas de SEO (función de auditoría del sitio) utilizando nuestra API REST.

Tenga en cuenta que, por motivos de seguridad, debe iniciar sesión con un usuario con la capacidad de manage_options.

Actualmente hay 2 rutas disponibles:

  • /wp-json/seopress/v1/seo-issues/[postId] : para obtener los problemas de SEO de la publicación, reemplace [postId] con el ID de la publicación deseada
  • /wp-json/seopress/v1/seo-issues/ para obtener todos los problemas, lista de argumentos disponibles a continuación:
    • id (opcional): ID de publicación
    • ignore (opcional): booleano (1 o 0)
    • type (opcional): all_canonical, json_schemas, old_post, permalink, headings, title, description, social, robots, img_alt, nofollow_links, outbound_links, internal_links
    • priority (opcional): high, medium, low, good
    • name (opcional): json_schemas_duplicated, json_schemas_not_found, old_post, keywords_permalink, headings_not_found, headings_h1_duplicated, headings_h1_not_found, headings_h1_without_target_kw, headings_h2_without_target_kw, headings_h3_without_target_kw, title_without_target_kw, title_too_long, title_not_custom, description_without_target_kw, description_too_long, description_not_custom, og_title_duplicated, og_title_empty, og_title_missing, og_desc_duplicated, og_desc_empty, og_desc_missing, og_img_empty, og_img_missing, og_url_duplicated, og_url_empty, og_url_missing, og_sitename_duplicated, og_sitename_empty, og_sitename_missing, x_title_duplicated, x_title_empty, x_title_missing, x_desc_duplicated, x_desc_empty, x_desc_missing, x_img_empty, x_img_missing, meta_robots_duplicated, meta_robots_noindex, meta_robots_nofollow, meta_robots_noimageindex, meta_robots_noarchive, meta_robots_nosnippet, meta_robots_nositelinkssearchbox, img_alt_missing, img_alt_no_media, nofollow_links_too_many, outbound_links_missing, internal_links_missing, canonical_duplicated, canonical_missing

Método disponible: GET.

Obtendrá una respuesta JSON con la siguiente información:

{
    "success": true,
    "data": [
        {
            "id": "1",
            "post_id": "1",
            "issue_name": "json_schemas_not_found",
            "issue_desc": "",
            "issue_type": "json_schemas",
            "issue_priority": "medium",
            "issue_ignore": "1"
        },
        {
            "id": "2",
            "post_id": "1",
            "issue_name": "keywords_permalink",
            "issue_desc": "",
            "issue_type": "permalink",
            "issue_priority": "medium",
            "issue_ignore": "0"
        },
        {
            "id": "3",
            "post_id": "1",
            "issue_name": "headings_h1_without_target_kw",
            "issue_desc": "",
            "issue_type": "headings",
            "issue_priority": "high",
            "issue_ignore": "0"
        }
    ];
}