# 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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/fejlesztoknek-rest-api/) 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ó. | ```json { "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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/strukturalt-adatok-automatikus-sema/) 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: ```json { "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: ```json { "title": "FAQ-séma", "type": "faq", "rules": [], "meta": { "_seopress_pro_rich_snippets_faq_...": "..." } } ``` | Argumentum | Leírása | |---|---| | `` | 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: ```json { "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: ```json { "_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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/oldalterkepek-video-terkep/) 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. ```json { "_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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/oldalterkepek-google-news/). ## 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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/ai-szolgaltatok-beallitasa/) 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`. ```json { "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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/atiranyitasok-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`. ```json { "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: ```json { "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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-pagespeed/). ## 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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-google-statisztika-csatlakoztatas/). ## 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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-matomo/). 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`: ```json { "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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/metaadatok-search-console-api/) fejezetet. ```json { "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). ```json { "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ő. ```json { "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" } ```