REST API: további útvonalak

A SEOPress REST API séma-, videótérkép-, Google News-, AI-, tartalomelemzés-, SEO-hiba-, sebesség-, analitika- és Insights-útvonalai.

Ez a fejezet a REST API további útvonalait gyűjti össze. A hitelesítésről, a bejegyzés- és tagmetaadatokról, a beállításokról és a biztonsági szabályokról a REST API: hitelesítés, olvasás, írás és biztonság fejezet szól. Ahol „PRO” áll, ott az útvonalhoz a SEOPress PRO kell.

Az útvonalak a /wp-json/seopress/v1/ alatt vannak, kivéve az Insights útvonalait (/wp-json/seopress-insights/v1/).

SEO-riasztások (PRO)

GET /wp-json/seopress/v1/alerts

Valós időben megmondja a három SEO-riasztás-ellenőrzés állapotát: a főoldal noindex-észlelését, a robots.txt elérhetőségét és az XML-oldaltérkép elérhetőségét. Az eredmény 5 percig gyorsítótárban marad. Szükséges jogosultság: manage_options.

Lekérés: /wp-json/seopress/v1/alerts
Friss ellenőrzés kényszerítése (a gyorsítótárat kikerüli): /wp-json/seopress/v1/alerts?force=true

Argumentum	Leírása
`[force]`	Logikai érték. Megkerüli a gyorsítótárat, és friss ellenőrzést kényszerít. Alapérték: false. Felhasználónként 60 másodpercenként egyszer hívható.

{
    "homepage_noindex": {
        "status": "ok",
        "checked_url": "https://example.com",
        "noindex_found": false
    },
    "robots_txt": {
        "status": "ok",
        "checked_url": "https://example.com/robots.txt",
        "http_code": 200
    },
    "xml_sitemap": {
        "status": "error",
        "checked_url": "https://example.com/sitemaps.xml",
        "http_code": 404
    },
    "timestamp": "2026-03-31T12:00:00+00:00"
}

Automatikus sémák (PRO)

Az automatikus sémasablonokat (strukturált adatokat) lekérheted, létrehozhatod, módosíthatod és törölheted. A sémákról az Automatikus séma: létrehozás, import és export fejezetben olvashatsz.

Művelet	Metódus és útvonal	Szükséges jogosultság
Az összes séma lekérése	`GET /wp-json/seopress/v1/schemas`	`edit_schemas`
Szűrés típusra	`GET /wp-json/seopress/v1/schemas?type=faq`	`edit_schemas`
Egy séma lekérése	`GET /wp-json/seopress/v1/schemas/[schemaId]`	`edit_schema`
Séma létrehozása	`POST /wp-json/seopress/v1/schemas`	`publish_schemas`
Séma módosítása	`PUT /wp-json/seopress/v1/schemas/[schemaId]`	`edit_schema`
Séma törlése	`DELETE /wp-json/seopress/v1/schemas/[schemaId]`	`delete_schema`

A type szűrő elfogadott értékei: articles, localbusiness, faq, howto, courses, recipes, jobs, videos, events, products, softwareapp, services, review, custom.

A lekérés válasza:

{
    "data": [
        {
            "id": 123,
            "title": "FAQ-séma",
            "type": "faq",
            "rules": [],
            "meta": {
                "_seopress_pro_rich_snippets_faq_...": "..."
            }
        }
    ],
    "total": 1
}

Létrehozásnál (POST) JSON-törzset küldesz:

{
    "title": "FAQ-séma",
    "type": "faq",
    "rules": [],
    "meta": {
        "_seopress_pro_rich_snippets_faq_...": "..."
    }
}

Argumentum	Leírása
`<title>`	A séma címe. Kötelező.
`<type>`	A séma típusa. Kötelező. Elfogadott értékek: lásd fent.
`[rules]`	Célzási szabályok (tartalomtípusok, taxonómiák stb.). Nem kötelező.
`[meta]`	A séma metaértékei. A kulcsoknak `_seopress_pro_rich_snippets_` előtaggal kell kezdődniük. Nem kötelező.

Módosításnál (PUT) a title, type, rules és meta mind elhagyható; csak azt küldd, amit változtatni akarsz.

Kézi sémák egy bejegyzéshez (PRO)

GET /wp-json/seopress/v1/posts/[postId]/schemas-manual

Visszaadja a bejegyzéshez beállított kézi rich snippeteket (strukturált adatokat), a választható sématípusokkal és mezőikkel együtt. Szükséges jogosultság: edit_post.

PUT /wp-json/seopress/v1/posts/[postId]/schemas-manual

Módosítja a bejegyzés kézi rich snippetjeit. Szükséges jogosultság: edit_post. Törzs:

{
    "schemas": [
        {
            "_seopress_pro_rich_snippets_type": "faq",
            "_seopress_pro_rich_snippets_faq": []
        }
    ]
}

Videótérkép-adatok egy bejegyzéshez (PRO)

GET /wp-json/seopress/v1/posts/[postId]/video-sitemap visszaadja a bejegyzés videótérkép-adatait: az összes videót és mezőiket (URL, cím, leírás, bélyegkép, hossz, értékelés stb.). Szükséges jogosultság: edit_post.

PUT /wp-json/seopress/v1/posts/[postId]/video-sitemap módosítja ezeket. Szükséges jogosultság: edit_post. Törzs:

{
    "_seopress_video_disabled": false,
    "videos": [
        {
            "url": "https://www.youtube.com/watch?v=xxxxx",
            "title": "A videó címe",
            "desc": "A videó leírása",
            "thumbnail": "https://example.com/belyegkep.jpg",
            "duration": 120,
            "rating": 4.5,
            "tag": "seo, wordpress",
            "family_friendly": false,
            "internal_video": false,
            "view_count": 1500
        }
    ]
}

A videótérképről az XML-videótérkép fejezet szól.

Google News-beállítások egy bejegyzéshez (PRO)

GET /wp-json/seopress/v1/posts/[postId]/google-news-settings visszaadja a bejegyzés Google News-oldaltérkép-beállításait. PUT ugyanezen az útvonalon módosítja őket. Mindkettőhöz edit_post jogosultság kell.

{
    "_seopress_news_disabled": "yes"
}

A _seopress_news_disabled értéke yes, ha ki akarod zárni a bejegyzést a Google News-oldaltérképből. Bármilyen más érték, vagy a mező elhagyása esetén a bejegyzés bekerül. Lásd még: Google News webhelytérkép.

SEO-metaadatok generálása AI-val (PRO)

POST /wp-json/seopress/v1/posts/[postId]/generate-metas-by-ai

SEO-címet és meta leírást generál a bejegyzéshez AI-val. Szükséges jogosultság: edit_post. Előtte állíts be AI-szolgáltatót (lásd az AI-szolgáltató beállítása fejezetet).

Argumentum	Leírása
`<postId>`	A bejegyzés azonosítója.
`[lang]`	A generálás nyelve (területi kód). Nem kötelező, alapérték a webhely nyelve (például `hu_HU`).

Példa magyar nyelvű generálásra: POST /wp-json/seopress/v1/posts/123/generate-metas-by-ai a következő törzzsel: {"lang": "hu_HU"}.

Közösségi metaadatok generálása AI-val (PRO)

POST /wp-json/seopress/v1/posts/[postId]/generate-social-metas-by-ai

Közösségi médiás metacímkéket (Open Graph vagy X) generál a bejegyzéshez. Szükséges jogosultság: edit_post.

Argumentum	Leírása
`<postId>`	A bejegyzés azonosítója.
`<platform>`	A közösségi platform. Elfogadott értékek: `facebook`, `twitter`.
`<meta_type>`	Melyik metaadatot generálja. Elfogadott értékek: `title`, `desc`.
`[lang]`	A generálás nyelve. Nem kötelező, alapérték a webhely nyelve.

Példa: POST /wp-json/seopress/v1/posts/123/generate-social-metas-by-ai ezzel a törzzsel: {"platform": "facebook", "meta_type": "title", "lang": "hu_HU"}.

Jelentős kulcsszavak javaslata (PRO)

GET /wp-json/seopress/v1/posts/[postId]/significant-keywords

A bejegyzés tartalmának elemzése alapján kulcsszójavaslatokat ad. Szükséges jogosultság: edit_post.

{
    "suggestions": [
        {"keyword": "seo", "count": 12, "density": 2.5},
        {"keyword": "wordpress", "count": 8, "density": 1.7}
    ]
}

SEO-problémák (webhelyaudit)

A webhelyaudit által talált SEO-problémákat lekérheted. Biztonsági okból manage_options jogosultságú felhasználóval kell bejelentkezned. Metódus: GET. A funkcióról lásd a Webhelyaudit fejezetet.

Két útvonal van:

/wp-json/seopress/v1/seo-issues/[postId]: egy bejegyzés SEO-problémái.
/wp-json/seopress/v1/seo-issues/: az összes probléma. Argumentumok:
- id (nem kötelező): bejegyzésazonosító.
- ignore (nem kötelező): logikai érték (1 vagy 0).
- type (nem kötelező): all_canonical, json_schemas, old_post, permalink, headings, title, description, social, robots, img_alt, nofollow_links, outbound_links, internal_links.
- priority (nem kötelező): high, medium, low, good.
- name (nem kötelező): a konkrét probléma neve. Értékei: 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_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.

{
    "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": "3",
            "post_id": "1",
            "issue_name": "headings_h1_without_target_kw",
            "issue_desc": "",
            "issue_type": "headings",
            "issue_priority": "high",
            "issue_ignore": "0"
        }
    ]
}

Tartalomelemzés

GET /wp-json/seopress/v1/posts/[postId]/content-analysis

Teljes tartalomelemzést futtat a bejegyzésen, és részletes SEO-ellenőrzéseket ad vissza (belső hivatkozások, kimenő hivatkozások, pontszám, kulcsszóhasználat stb.). Szükséges jogosultság: edit_post.

A válasz tartalmaz egy score_summary mezőt is: hány ellenőrzésen ment át és hányon bukott a bejegyzés, és hány futott le összesen (passed, failed, total), a figyelmen kívül hagyott ellenőrzések nélkül. Ez az arány látszik a Score oszlopban. A score az egyes ellenőrzések hatását adja meg, ellenőrzésenként kulcsolva. Aki a Content Analysis: blocked roles listán szerepel, nem kérheti le az elemzést.

Argumentum	Leírása
`<postId>`	A bejegyzés azonosítója.
`[target_keywords]`	Nem kötelező. Az elemzendő kulcsszavak vesszővel elválasztva. Ha elhagyod, az adatbázisban mentett kulcsszavakat használja.

POST /wp-json/seopress/v1/posts/[postId]/content-analysis

Elmenti a bejegyzés tartalomelemzési adatait (belső hivatkozások, kimenő hivatkozások és pontszám). Szükséges jogosultság: edit_post. Törzs:

{
    "score": "good",
    "internal_links": ["https://example.com/oldal1", "https://example.com/oldal2"],
    "outbound_links": ["https://external.example.org/oldal1"]
}

Google PageSpeed-jelentés

GET /wp-json/seopress/v1/page-speed

Lekéri a Google PageSpeed-jelentést. Biztonsági okból manage_options jogosultságú felhasználóval kell bejelentkezned. Argumentum: device (nem kötelező): mobile (alapérték) vagy desktop. A válasz JSON. Lásd még: PageSpeed Insights elemzés.

Google Analytics 4 statisztikák

GET /wp-json/seopress/v1/ga4

Lekéri a Google Analytics 4 statisztikákat. Biztonsági okból edit_dashboard jogosultságú felhasználóval kell bejelentkezned. A válasz JSON, az összes mutatóval dátumonként. Lásd még: Google Analytics statisztikák a vezérlőpulton.

Matomo-statisztikák

GET /wp-json/seopress/v1/matomo

Lekéri a Matomo Analytics statisztikákat. Biztonsági okból edit_dashboard jogosultságú felhasználóval kell bejelentkezned. A válasz JSON, az összes mutatóval dátumonként. Lásd még: Matomo követés és statisztikák.

Ha a legutóbbi Matomo-szinkronizálás sikertelen volt (PRO), a válasz üres helyett megmondja az okot. A reason értéke token_rejected, unreachable, unreadable vagy other:

{
    "error": {
        "reason": "unreachable",
        "summary": "Your Matomo instance could not be reached.",
        "hint": "Check the Matomo URL, that the instance is up, and that its TLS certificate is valid.",
        "response": "",
        "time": 1761643200,
        "date": "October 28, 2026 9:20 am"
    }
}

Google Search Console jelentések egy bejegyzéshez

/wp-json/seopress/v1/posts/[postID]/inspect

Lekéri a bejegyzés Google Search Console URL-vizsgálati jelentését. Biztonsági okból edit_post jogosultságú felhasználóval kell bejelentkezned. Metódus: GET, POST. A beállításáról lásd a Google Search Console API a SEOPress PRO-ban fejezetet.

{
    "google_api_key_is_empty": false,
    "data": {
        "inspectionResult": {
            "inspectionResultLink": "https://search.google.com/search-console/inspect?resource_id=https://example.com/&id=xxxxxxxx",
            "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"
                            }
                        ]
                    }
                ]
            }
        }
    }
}

SEOPress Insights útvonalai

Az Insights útvonalai a /wp-json/seopress-insights/v1/ alatt vannak. Mindegyikhez a megfelelő Insights-jogosultság kell, és biztonsági okból manage_options jogosultságú felhasználóval kell bejelentkezned. Metódus: GET, ha nincs másként megadva.

Helyezések

/wp-json/seopress-insights/v1/rankings. Argumentumok: kws (nem kötelező, azonosítók tömbje), cpt (nem kötelező, szöveg: seopress_rankings), dates (nem kötelező, időbélyegek tömbje).

{
    "2025/02/17": [
        {
            "keyword": "kulcsszavad",
            "p": 18,
            "url": "https://example.com/pelda",
            "search_volume": 2900,
            "cpc": 4.11,
            "competition": 0.13,
            "date": 1739760053,
            "added": 1634064757,
            "id": 7389
        }
    ]
}

Versenytársak

/wp-json/seopress-insights/v1/competitors: az első helyen rangsorolt versenytársak. Argumentumok: kws, cpt (szöveg: seopress_p1_rankings) és dates. A válasz szerkezete megegyezik a helyezésekéével.

Hivatkozások (backlinkek)

/wp-json/seopress-insights/v1/backlinks: a bejövő hivatkozások listája. Egy elem mezői többek között: backlink, anchor_text, source_title, target_url, first_indexed_date, last_seen_date, date_lost, reason_lost, link_type, valamint a forrás- és célmegbízhatósági mutatók (source_cf, source_tf, target_citation_flow, target_trust_flow) és a jelzők (flag_no_follow, flag_images, flag_redirect, flag_deleted stb.).

Az Insights vezérlőpultja

GET /wp-json/seopress-insights/v1/dashboard: a vezérlőpult adatai: a mutatók összegzése, a helyezések alakulása, a mozgó kulcsszavak, a pozíció-eloszlás, a kedvenc kulcsszavak és a hivatkozások összegzése.

Hivatkozás kézi felvétele

POST /wp-json/seopress-insights/v1/backlinks/manual

Olyan hivatkozást vehetsz fel, amelyet az automatikus import nem talált meg, például partnerséget vagy vendégcikket. Csak a source_url kötelező.

{
  "source_url": "https://example.com/blog/bejegyzes",
  "target_url": "https://a-te-webhelyed.example/oldal",
  "anchor_text": "a hivatkozás szövege",
  "source_language": "hu",
  "flag_no_follow": false,
  "source_cf": 30,
  "source_tf": 25,
  "first_indexed_date": "2026-08-01",
  "source_topical_tf": "Computers/Internet"
}

Készült: 2026. november 2.