API
検査
再検査の開始
リクエスト形式
POST /audit/{site_id}/recheck結果
正常の場合はサーバーからHTTP 200が返されます。
検査 ステータス
リクエスト フォーマット
GET /audit/{site_id}
結果
成功すると、サーバーは検査のステータスを返します。
例
{
"status": "finished",
"start_time": "2018-06-15 12:41:13",
"audit_time": "2018-09-11 16:13:41",
"total_pages": 10,
"total_warnings": 71,
"total_errors": 21,
"total_passed": 810
}レスポンス パラメータ
| 名称 | 説明 |
| status | cancelled; expired – 検査実施から3ヶ月以上経過している; queued; processing – 検査中; finished – 検査完了。 |
| start_time | 検査開始時刻 |
| audit_time | 検査終了時刻 |
| total_pages | スキャンページ数合計 |
| total_warnings | 必要な修正項目の合計数 |
| total_errors | 重要な修正項目の合計数 |
| total_passed | 検査合格の合計数 |
検査レポート
検査が完了している場合のみデータは利用可能です(“is_finished”: true)
リクエスト フォーマット
GET /audit/{site_id}/report
Result
- “is_finished”: true – 検査レポートデータが利用できます。
- “is_finished”: false – 検査が完了していない場合。
結果
{
"is_finished": false
}{
"is_finished": true,
"domain_props": {
"archiveOrg": "2003-02-26",
"backlinks": "4",
….
},
"sections": [
{
"uid": "tech_audit",
"name": "Section name",
"props": [
{
"code": "_images_500_count",
"status": "passed",
"name": "Image with 5xx status",
"value": "0"
},
…],
...
],
"score_percent": 79,
"total_pages": 10,
"total_warnings": 71,
"total_errors": 21,
"total_passed": 810,
"screenshot": "http://host/screenshots/147683.jpg",
"audit_time": "2018-09-11 16:13:41"
}レスポンス パラメータ
| 名称 | 説明 |
| is_finished | 検査 ステータス |
| domain_props | ドメイン 情報と各パラメータ |
| score_percent | % 表記のレイティング |
| screenshot | スクリーンショットのリンク |
| audit_time | 検査終了時刻 |
| total_pages | スキャンしたページの合計数 |
| total_notices | 通知の数 |
| total_warnings | 必要な修正項目の合計数 |
| total_errors | 重要な修正項目の合計数 |
| total_passed | 検査に合格した合計数 |
| sections | 検査セクション |
| uid | セクション ID |
| name | セクション 名 |
| props | セクション チェックのリスト |
ドメイン 情報と各パラメータ
| 名称 | 説明 |
| avgLoadSpeed | 平均ページ表示速度 |
| archiveOrg | archive.orgの年数 |
| expdate | ドメイン有効期限日 |
| IpCountry | 国 |
| ip | IP |
| yandex_x | Yandex X |
| backlinks | 被リンク |
| index_google | Google インデックス ページ数 |
| index_bing | Bing インデックス ページ数 |
| index_yahoo | Yahoo インデックス ページ数 |
| index_yandex | Yandex インデックス ページ数 |
セクション チェックのリスト
| 名称 | 説明 |
| status | warning | error | passed |
| code | チェック コード (次のセクションのみ: uid = props_*) |
| value | チェックの 値 (次のセクションのみ: uid = props_*) |
ページのリスト
このメソッドは、指定されたチェックに関するページのリストを取得する事ができます。
リクエスト フォーマット
GET /audit/{site_id}/links?code={code}&limit=100&offset=10
リクエスト パラメータ
| 名称 | 必須 | 説明 |
| code | はい | GET /audit/{site_id}/report を参照 |
| limit | いいえ | リンク数合計。 最大リンク数 – 100 |
| offset | いいえ | オフセット値 |
結果
成功すると、サーバーは指定したチェックのページのリストを返します。
例
{
"total_urls": 10,
"urls": [
{
"id": 1248462,
"url": "https://seranking.com/"
},
...
],
"urls_type": "urls_and_sources"
}"total_urls": 10,
"urls": [
"https://seranking.com/keyword-suggestion-tool.html",
...
],
"urls_type": "simple_urls_array"
{
"total_urls": 2,
"urls": {
"Online SEO Tools by SE Ranking": {
"found_on_urls": [
{
"url": "https://seranking.com/position-tracking.html",
"id": "1248466",
"cnt": "10"
},
...
],
}
,
"urls_type": "duplicate_props"
}レスポンス パラメータ
| 名称 | 説明 |
| total_urls | URLの合計数 |
| urls | URLのリスト。リストのフォーマットはチェックのタイプによって異なります。 |
| urls_type | リストのタイプ simple_urls_array duplicate_props urls_and_single_source urls_and_sources |
エラー
| HTTP コード | エラーメッセージ |
| 400 | Invalid code |
検査 履歴
リクエスト フォーマット
GET /audit/{site_id}/history?date=2018-06-01リクエスト パラメータ
| 名称 | 必須 | 説明 |
| date | はい | 検査 日 |
例
{
"audit_time": "2018-06-01 13:25:29",
"domain_data": {
"age": "1",
"archiveOrg": "ew",
"AvoidInterstitials": "1",
"AvoidInterstitials_mobile": "1",
"AvoidLandingPageRedirects": "1",
"AvoidLandingPageRedirects_mobile": "1",
"AvoidPlugins": "1",
"AvoidPlugins_mobile": "1",
"commonHomepageVars": "0",
"ConfigureViewport": "1",
"ConfigureViewport_mobile": "1",
"Correct404Pages": "1",
"EnableGzipCompression": "0",
"EnableGzipCompression_mobile": "1",
"expdate": "2018-10-10",
"HasFavicon": "1",
"hasFlash": "0",
"hasHttps": "0",
"hasRobotsTxt": "1",
"HasSeofriendlyUrls": "1",
"hasXmlSitemap": "1",
"index_yahoo": "1",
"index_yandex": "9",
"ip": "148.251.49.8",
"IpCountry": "Germany",
"IsSafeBrowsing": "1",
"LeverageBrowserCaching": "0",
"LeverageBrowserCaching_mobile": "0",
"MainResourceServerResponseTime": "1",
"MainResourceServerResponseTime_mobile": "1",
"MinifyCss": "1",
"MinifyCss_mobile": "1",
"MinifyHTML": "0",
"MinifyHTML_mobile": "1",
"MinifyJavaScript": "0",
"MinifyJavaScript_mobile": "1",
"MinimizeRenderBlockingResources": "0",
"MinimizeRenderBlockingResources_mobile": "0",
"OnYandexCatalog": "0",
"OptimizeImages": "0",
"OptimizeImages_mobile": "0",
"PrioritizeVisibleContent": "1",
"PrioritizeVisibleContent_mobile": "1",
"SizeContentToViewport": "1",
"SizeContentToViewport_mobile": "1",
"SizeTapTargetsAppropriately": "1",
"SizeTapTargetsAppropriately_mobile": "1",
"UseLegibleFontSizes": "1",
"UseLegibleFontSizes_mobile": "1",
"WwwRedir": "0",
"avgLoadSpeed": "117.4000"
},
"settings": {
"schedule_type": "manual",
"schedule_day": 1,
"schedule_hour": 1,
"schedule_wday": 1,
"source_site": 1,
"source_subdomain": 0,
"source_sitemap": "0",
"source_file": 0,
"check_robots": "1",
"ignore_params": 0,
"custom_params": "utm_source, utm_medium, cid, PHPSESSID",
"user_agent": 0,
"login": "",
"password": "",
"max_depth": 10,
"max_req": "5",
"min_title_len": 10,
"max_title_len": 70,
"min_description_len": 50,
"max_description_len": 320,
"max_h1_len": 60,
"max_h2_len": 60,
"min_words": "500",
"max_links": "10",
"max_size": "10",
"max_redirects": "3",
"max_pages": "10"
},
"pages_data": {
"_2xx_pagesCount": 10,
"_3xx_pagesCount": 0,
"_4xx_pagesCount": 0,
"_5xx_pagesCount": 0,
"_too_big_pagesCount": 10,
"_too_long_url_pagesCount": 0,
"_blocked_by_robotstxt_pagesCount": 0,
"_blocked_by_xrobots_pagesCount": "0",
"_blocked_by_nofollow_pagesCount": 0,
"_meta_refresh_pagesCount": 0,
"_rel_canonical_pagesCount": 8,
"_no_rel_canonical_pagesCount": 2,
"_duplicate_canonical_pagesCount": 0,
"_duplicate_canonical_tag": 0,
"_rel_alternate_pagesCount": 10,
"_hreflang_pagesCount": 10,
"_no_hreflang_pagesCount": 0,
"_error_hreflang_pagesCount": 0,
"_duplicate_title_pagesCount": 0,
"_no_title_pagesCount": 0,
"_long_title_pagesCount": 0,
"_short_title_pagesCount": 0,
"_no_descr_pagesCount": 0,
"_duplicate_descr_pagesCount": 0,
"_short_descr_pagesCount": 0,
"_long_descr_pagesCount": 0,
"_duplicate_content_pagesCount": 0,
"_low_word_count_pagesCount": 0,
"_h1_empty_pagesCount": 0,
"_no_h1_pagesCount": 0,
"_long_h1_pagesCount": 1,
"_duplicate_h1_pagesCount": 0,
"_h2_empty_pagesCount": 0,
"_no_h2_pagesCount": 0,
"_long_h2_pagesCount": 2,
"_many_ext_links_pagesCount": 10,
"_many_redirects_links": 0,
"_int_links_no_title_count": 0,
"_ext_links_no_title_count": 40,
"_int_links_nofollow_count": 343,
"_ext_links_nofollow_count": 101,
"_no_intlinks_pagesCount": 0,
"_ext_links_dofollow_count": 68,
"_ext_links_400_count": 0,
"_ext_links_500_count": 0,
"_ext_links_all_count": 169,
"_sitemap_links_all_count": 44,
"_images_no_alt_count": 18,
"_images_400_count": "0",
"_images_500_count": "0",
"_trailing_slashes": 0,
"_frames_count": 0,
"_flash_pages_count": 0
},
"totals": {
"total_pages": 10,
"total_warnings": 70,
"total_errors": 22,
"total_passed": 830
}レスポンス パラメータ
| 名称 | 説明 |
| audit_time | 検査 終了 時刻 |
| domain_data | ドメインとサイト全てに関連するパラメータ |
| settings | 設定 (サイト設定が個別に設定されていない場合は、パラメータが失われることもあります) |
| pages_data | ページ チェック パラメータ |
| totals | GET /audit/{site_id} を参照 |
