見出し画像

【2025年7月】noteの非公式APIを整理

ブオナローティ

本記事の執筆時点で利用可能なnote非公式APIをいくつか整理してみた。
全てGETメソッド（情報の取得）のみの紹介であり、使用可能なエンドポイントを網羅したものではない点に注意。


なお本記事では、実行するAPIエンドポイントを引用、実行結果をコードに分けて記載する。

https://note.com/api/v2/…

APIエンドポイント
{
    "data": "APIエンドポイントの実行結果"
}

クリエイター情報

特定のクリエイター情報

{クリエイターID}にクリエイターIDを指定することで、ニックネームやプロフィール、フォロー数とやフォロワー数などが取得できる。

https://note.com/api/v2/creators/{クリエイターID}

{クリエイターID}に私のIDであるfuji1080を指定すると、以下結果が得られる。

{
	"data": {
		"id": 6984930,
		"key": "80a4dba2808d9923fde6626410d91234",
		"nickname": "ブオナローティ",
		"urlname": "fuji1080",
		"profile": "神奈川在住のITエンジニア。2児の父。",
		"noteCount": 156,
		"magazineCount": 0,
		"followingCount": 5,
		"followerCount": 2,
		"isFollowing": false,
		"isFollowed": false,
		"isMyself": true,
		"originalHeaderImageUrl": null,
		"headerImageUrl": null,
		"headerImageKey": null,
		"profileImageUrl": "https://assets.st-note.com/production/uploads/images/177877668/profile_2881984a0bf64ccfe76742c0e0d7aa25.png?fit=bounds&format=jpeg&quality=85&width=330",
		"profileImageKey": "2881984a0bf64ccfe76742c0e0d7aa25",
		"isBlocked": false,
		"blocksYou": false,
		"isAdmin": false,
		"socials": {},
		"isOfficial": false,
		"showFollowCount": true,
		"externalLinks": {},
		"disableSupport": false,
		"hasStore": false,
		"hasCircle": false,
		"customDomain": null,
		"followAppealText": null,
		"followAppealImage": null,
		"isCreatorLikesTabEnabled": true,
		"isCreatorMagazinesTabEnabled": true,
		"isCreatorCirclesTabEnabled": true,
		"isCreatorArchivesTabEnabled": true,
		"isCreatorProfileTabEnabled": true,
		"isCreatorJobOfferTabEnabled": false,
		"isCreatorFollowNumberDisplayed": true,
		"isCreatorPopularSortEnabled": true,
		"style": "streem",
		"isPro": false,
		"proUserId": null,
		"tlMagazines": [],
		"isMedia": false,
		"storeUrl": "",
		"jobSourceUrl": null,
		"isHavingSubscribableMagazines": false
	}
}

クリエイターを検索

{検索キーワード}にキーワードを指定することで、クリエイターのURL名やプロフィール文章から検索した結果が出力される。
複数キーワードの指定方法などは未検証。

https://note.com/api/v3/searches?context=user&q={検索キーワード}

{検索キーワード}をgeminiとした結果は以下の通り。

{
	"data": {
		"note_cursor": "initial",
		"user_cursor": "4",
		"magazine_cursor": "initial",
		"hashtag_cursor": "initial",
		"circle_cursor": "initial",
		"note_for_sale_cursor": "initial",
		"notes": {},
		"magazines": {},
		"users": {
			"is_last_page": null,
			"contents": [
				{
					"id": 9503739,
					"urlname": "google_gemini",
					"profile": "Google が開発･提供する生成 AI「Gemini (ジェミニ)」の公式アカウントです。日々進化する Gemini の最新情報や活用事例をお届けします。Gemini を使ってみるなら → https://gemini.google.com/",
					"key": "459091fde4cae874b056daf6d0eaf5ac",
					"nickname": "Gemini - Google の AI",
					"following_count": 2,
					"follower_count": 17830,
					"is_following": true,
					"is_myself": false,
					"profile_image_url": "https://assets.st-note.com/production/uploads/images/144338230/profile_79cde26a48eeb004b786cbb9838ee861.png?fit=bounds&format=jpeg&quality=85&width=330",
					"is_blocked": false,
					"is_official": false,
					"show_follow_count": true,
					"custom_domain": null,
					"follow_appeal_text": null,
					"follow_appeal_image": null
				},
				{
					"id": 257846,
					"urlname": "gemini",
					"profile": "test",
					"key": "e57a3166c91892d9651b87f4de4f689b",
					"nickname": "gemi",
					"following_count": 1,
					"follower_count": 1,
					"is_following": false,
					"is_myself": false,
					"profile_image_url": "https://d2l930y2yx77uc.cloudfront.net/assets/default/default_profile_2-5375e0fe14f8f6451ac8859ef34c1b34d978cfaec6bf1222d0655ad5412d97f6.png",
					"is_blocked": false,
					"is_official": false,
					"show_follow_count": true,
					"custom_domain": null,
					"follow_appeal_text": null,
					"follow_appeal_image": null
				},
				{
					"id": 2229363,
					"urlname": "gemini6rabbit",
					"profile": "京都在住♀　写真を撮る事　読書　園芸が好きです。ここ数年はオールドレンズで撮っています。自営業・コロナ禍で仕事は実質休業中。次の仕事を模索中。下戸。→insta: @zaki_photofromkyoto　@mini.june.rab",
					"key": "6b9082c05322b15d6c725813d9fe9f8d",
					"nickname": "K.zaki",
					"following_count": 62,
					"follower_count": 111,
					"is_following": false,
					"is_myself": false,
					"profile_image_url": "https://assets.st-note.com/production/uploads/images/18341245/profile_14478ceec6189c8169b690770b7f2e7c.jpg?fit=bounds&format=jpeg&quality=85&width=330",
					"is_blocked": false,
					"is_official": false,
					"show_follow_count": true,
					"custom_domain": null,
					"follow_appeal_text": "フォローありがとうございます。どうぞよろしくお願いいたします。",
					"follow_appeal_image": null
				},
				{
					"id": 11087526,
					"urlname": "kawakijourney_ai",
					"profile": "＼AIの役立つnoteを毎日更新してます／\n・AI好きの20代/ SNS総フォロワー8万人\n・AI画像生成のコツを解説\n・ツール：Midjourney / KLING/ SUNO/imageFX/ChatGPT/Gemini/Runwayなど\nぜひフォローよろしくお願いします！",
					"key": "d22856bd3327c1f0a6901420c9bdfd8b",
					"nickname": "AI かわき｜世界一優しいAI画像生成の解説",
					"following_count": 16,
					"follower_count": 1046,
					"is_following": false,
					"is_myself": false,
					"profile_image_url": "https://assets.st-note.com/production/uploads/images/186104141/profile_8589de0606721ab22cbc91de6fc0b629.jpg?fit=bounds&format=jpeg&quality=85&width=330",
					"is_blocked": false,
					"is_official": false,
					"show_follow_count": true,
					"custom_domain": null,
					"follow_appeal_text": "フォローありがとうございます。頑張れます！",
					"follow_appeal_image": "https://assets.st-note.com/production/uploads/images/196003183/339c0843e6aa66ae75c8410292864f60.png?fit=bounds&format=jpeg&height=500&quality=85&width=500"
				}
			],
			"top_search_contents": [],
			"total_count": 522,
			"rounded_total_count": 500
		},
		"hashtags": {},
		"circles": {},
		"notes_for_sale": {},
		"cursor": {
			"note": "initial",
			"magazine": "initial",
			"user": "4",
			"hashtag": "initial",
			"circle": "initial",
			"note_for_sale": "initial"
		}
	}
}

記事情報

最新記事のタイムライン

以下のAPIエンドポイントで、最新記事のタイムラインが取得できる。
記事の更新もタイムラインに掲載されるのかは不明。
数秒単位で新しい記事がどんどん投稿されているのを見てるだけでも楽しい。

https://note.com/api/v3/notes

（データ量が多いため、実行結果の掲載は割愛）

特定の記事情報

{記事ID}を指定することで、記事の本文を含む詳細情報を確認できる。
通常の記事もつぶやきも、APIエンドポイントは同じ。

https://note.com/api/v3/notes/{記事ID}/

{記事ID}にn1844603fb2e7（以下記事のID）を指定した場合の結果はこちら。
クリエイター情報が長いため、一部削除している。

{
	"data": {
		"id": 117502157,
		"user_id": 6984930,
		"status": "published",
		"type": "TalkNote",
		"key": "n1844603fb2e7",
		"slug": "slug-n1844603fb2e7",
		"name": "",
		"body": "仕事や私生活が上手く進まないとき、数学的思考で考えると上手くいくのではないか、と思うようになった。\n・何がどうなればゴールなのか？\n・前提条件と制約事項は何か？\n・前提条件を網羅するために何が必要か？\n・もし制約事項を一部緩和できるならどんな手段が追加できそうか？\nという感じ。",
		"separator": null,
		"description": "",
		"external_url": null,
		"disable_comment": false,
		"editable_scopes": [
			"web",
			"ios",
			"android"
		],
		"non_editable_reason": null,
		"capabilities": {
			"amazonpay_campaign": false,
			"amazonpay": false,
			"guest_amazonpay": false,
			"ruby_text": false,
			"formula_text": false,
			"duplication": false
		},
		"created_at": "2025-06-29T15:39:24.000+09:00",
		"user": {
			"id": 6984930,
			"key": "80a4dba2808d9923fde6626410d91234",
			"urlname": "fuji1080",
			"nickname": "ブオナローティ"
		},
		"audio": null,
		"belonging_magazine_keys": [],
		"can_comment": true,
		"can_delete": true,
		"can_member_edit": false,
		"can_member_publish": false,
		"can_member_read": false,
		"can_member_write": false,
		"can_multiple_limited_note": true,
		"can_publish": true,
		"can_read": true,
		"can_sell_on_first_come_note": false,
		"can_update": true,
		"can_vote": true,
		"can_show_hashtag_banner": true,
		"categories": [],
		"category": null,
		"classify_categories": [],
		"comment_viewable": true,
		"custom_domain": null,
		"embedded_contents": [],
		"enable_backto_draft": true,
		"eyecatch": "https://assets.st-note.com/production/uploads/images/199038521/picture_mobile_de9ab1cdf7b3d196113c39d6560172bb.jpg?fit=bounds&format=jpeg&quality=85&width=700",
		"eyecatch_alt": "見出し画像",
		"eyecatch_height": null,
		"eyecatch_width": null,
		"format": "3.0",
		"has_coupon": false,
		"has_draft": false,
		"hashtag_notes": [
			{
				"id": 743026731,
				"created_at": "2025-06-29T15:40:05.000+09:00",
				"hashtag": {
					"name": "#今日の振り返り"
				}
			},
			{
				"id": 743026728,
				"created_at": "2025-06-29T15:40:05.000+09:00",
				"hashtag": {
					"name": "#雑感"
				}
			},
			{
				"id": 743026729,
				"created_at": "2025-06-29T15:40:05.000+09:00",
				"hashtag": {
					"name": "#論理的思考"
				}
			},
			{
				"id": 743026730,
				"created_at": "2025-06-29T15:40:05.000+09:00",
				"hashtag": {
					"name": "#ものの考え方"
				}
			},
			{
				"id": 743026732,
				"created_at": "2025-06-29T15:40:05.000+09:00",
				"hashtag": {
					"name": "#数学的思考"
				}
			}
		],
		"is_available": false,
		"is_circle_description": false,
		"is_draft": false,
		"is_for_work": false,
		"is_purchased_within_last_24_hours": false,
		"is_liked": true,
		"is_limited": false,
		"is_magazine_purchased": false,
		"is_member_edit": false,
		"is_member_editing": false,
		"is_my_note": true,
		"is_pinned": false,
		"is_profiled": false,
		"is_published": true,
		"is_purchased": false,
		"is_r18": false,
		"is_r18_confirmation_needed": false,
		"is_refund": false,
		"is_reserved": false,
		"is_supported": false,
		"is_temporary_frozen": false,
		"is_trial": false,
		"labels": [],
		"like_count": 1,
		"anonymous_like_count": 0,
		"magazines_for_buy": [],
		"magazines_for_subscribe": [],
		"member_edit_locked_at": null,
		"note_share_url": "https://note.com/intent/post?url=https://note.com/fuji1080/n/n1844603fb2e7",
		"related_contests": [
			{
				"id": 693,
				"note_id": null,
				"note": {
					"key": null,
					"user": {
						"urlname": null
					}
				},
				"hashtag": {
					"id": 419013,
					"name": "#今日の振り返り",
					"count": 74733
				},
				"name": "#今日の振り返り",
				"type": "theme",
				"state": "opened",
				"message": "今日1日のできごと、やったこと、気づいたことなど……。あなたの1日、noteに残しておきませんか？",
				"banner_image": "",
				"eyecatch_url": "https://assets.st-note.com/poc-image/manual/production/12.png",
				"color": "yellow",
				"sponsor": "",
				"open_at": "2024/01/10 00:00",
				"close_at": "2100/01/01 00:00"
			}
		],
		"paywall": {
			"is_simple_paid_note": true,
			"is_simple_paid_note_test_a": false,
			"same_month_cnt": 0,
			"context": {
				"is_show_limited_pay_note_paywall": false,
				"is_membership_connected": false
			}
		},
		"pictures": [
			{
				"caption": null,
				"key": "de9ab1cdf7b3d196113c39d6560172bb",
				"url": "https://assets.st-note.com/production/uploads/images/199038521/picture_pc_de9ab1cdf7b3d196113c39d6560172bb.jpg",
				"thumbnail_url": "https://assets.st-note.com/production/uploads/images/199038521/square_thumb_de9ab1cd.jpg",
				"alt": "画像1",
				"width": 6000,
				"height": 4000,
				"index": 0
			}
		],
		"pinned_user_note_id": null,
		"price": 0,
		"prior_sale": null,
		"publish_at": "2025-06-29T15:39:24.000+09:00",
		"reading_uuid": "fe00f994-1a3d-46c3-a049-f481baab00a5",
		"remained_char_num": 0,
		"remained_figure_num": 0,
		"remained_image_num": 0,
		"remained_file_num": 0,
		"reserved_publish_at": null,
		"send_notifications_flag": true,
		"facebook_share_url": "https://www.facebook.com/share.php?u=https://note.com/fuji1080/n/n1844603fb2e7&t=%E4%BB%95%E4%BA%8B%E3%82%84%E7%A7%81%E7%94%9F%E6%B4%BB%E3%81%8C%E4%B8%8A%E6%89%8B%E3%81%8F%E9%80%B2%E3%81%BE%E3%81%AA%E3%81%84%E3%81%A8%E3%81%8D%E3%80%81%E6%95%B0%E5%AD%A6%E7%9A%84%E6%80%9D%E8%80%83%E3%81%A7%E8%80%83%E3%81%88%E3%82%8B%E3%81%A8%E4%B8%8A%E6%89%8B%E3%81%8F%E3%81%84%E3%81%8F%E3%81%AE%E3%81%A7%E3%81%AF%E3%81%AA%E3%81%84%E3%81%8B%E3%80%81%E3%81%A8%E6%80%9D%E3%81%86%E3%82%88%E3%81%86%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F%E3%80%82%0A%E3%83%BB%E4%BD%95%E3%81%8C%E3%81%A9%E3%81%86%E3%81%AA%E3%82%8C%E3%81%B0%E3%82%B4%E3%83%BC%E3%83%AB%E3%81%AA%E3%81%AE%E3%81%8B%EF%BC%9F%0A%E3%83%BB%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6%E3%81%A8%E5%88%B6%E7%B4%84%E4%BA%8B%E9%A0%85%E3%81%AF%E4%BD%95%E3%81%8B%EF%BC%9F%0A%E3%83%BB%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6%E3%82%92%E7%B6%B2%E7%BE%85%E3%81%99%E3%82%8B%E3%81%9F%E3%82%81%E3%81%AB%E4%BD%95%E3%81%8C%E5%BF%85%E8%A6%81%E3%81%8B%EF%BC%9F%0A%E3%83%BB%E3%82%82%E3%81%97%E5%88%B6%E7%B4%84%E4%BA%8B%E9%A0%85%E3%82%92%E4%B8%80%E9%83%A8%E7%B7%A9%E5%92%8C%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%AA%E3%82%89%E3%81%A9%E3%82%93%E3%81%AA%E6%89%8B%E6%AE%B5%E3%81%8C%E8%BF%BD%E5%8A%A0%E3%81%A7%E3%81%8D%E3%81%9D%E3%81%86%E3%81%8B%EF%BC%9F%0A%E3%81%A8%E3%81%84%E3%81%86%E6%84%9F%E3%81%98%E3%80%82%EF%BD%9C%E3%83%96%E3%82%AA%E3%83%8A%E3%83%AD%E3%83%BC%E3%83%86%E3%82%A3%EF%BD%9Cnote%EF%BC%88%E3%83%8E%E3%83%BC%E3%83%88%EF%BC%89",
		"line_share_url": "https://line.naver.jp/R/msg/text/?%E4%BB%95%E4%BA%8B%E3%82%84%E7%A7%81%E7%94%9F%E6%B4%BB%E3%81%8C%E4%B8%8A%E6%89%8B%E3%81%8F%E9%80%B2%E3%81%BE%E3%81%AA%E3%81%84%E3%81%A8%E3%81%8D%E3%80%81%E6%95%B0%E5%AD%A6%E7%9A%84%E6%80%9D%E8%80%83%E3%81%A7%E8%80%83%E3%81%88%E3%82%8B%E3%81%A8%E4%B8%8A%E6%89%8B%E3%81%8F%E3%81%84%E3%81%8F%E3%81%AE%E3%81%A7%E3%81%AF%E3%81%AA%E3%81%84%E3%81%8B%E3%80%81%E3%81%A8%E6%80%9D%E3%81%86%E3%82%88%E3%81%86%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F%E3%80%82%0A%E3%83%BB%E4%BD%95%E3%81%8C%E3%81%A9%E3%81%86%E3%81%AA%E3%82%8C%E3%81%B0%E3%82%B4%E3%83%BC%E3%83%AB%E3%81%AA%E3%81%AE%E3%81%8B%EF%BC%9F%0A%E3%83%BB%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6%E3%81%A8%E5%88%B6%E7%B4%84%E4%BA%8B%E9%A0%85%E3%81%AF%E4%BD%95%E3%81%8B%EF%BC%9F%0A%E3%83%BB%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6%E3%82%92%E7%B6%B2%E7%BE%85%E3%81%99%E3%82%8B%E3%81%9F%E3%82%81%E3%81%AB%E4%BD%95%E3%81%8C%E5%BF%85%E8%A6%81%E3%81%8B%EF%BC%9F%0A%E3%83%BB%E3%82%82%E3%81%97%E5%88%B6%E7%B4%84%E4%BA%8B%E9%A0%85%E3%82%92%E4%B8%80%E9%83%A8%E7%B7%A9%E5%92%8C%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%AA%E3%82%89%E3%81%A9%E3%82%93%E3%81%AA%E6%89%8B%E6%AE%B5%E3%81%8C%E8%BF%BD%E5%8A%A0%E3%81%A7%E3%81%8D%E3%81%9D%E3%81%86%E3%81%8B%EF%BC%9F%0A%E3%81%A8%E3%81%84%E3%81%86%E6%84%9F%E3%81%98%E3%80%82%EF%BD%9C%E3%83%96%E3%82%AA%E3%83%8A%E3%83%AD%E3%83%BC%E3%83%86%E3%82%A3%EF%BD%9Cnote%EF%BC%88%E3%83%8E%E3%83%BC%E3%83%88%EF%BC%89%0Ahttps://note.com/fuji1080/n/n1844603fb2e7",
		"twitter_share_url": "https://twitter.com/intent/tweet?url=https://note.com/fuji1080/n/n1844603fb2e7&text=%E4%BB%95%E4%BA%8B%E3%82%84%E7%A7%81%E7%94%9F%E6%B4%BB%E3%81%8C%E4%B8%8A%E6%89%8B%E3%81%8F%E9%80%B2%E3%81%BE%E3%81%AA%E3%81%84%E3%81%A8%E3%81%8D%E3%80%81%E6%95%B0%E5%AD%A6%E7%9A%84%E6%80%9D%E8%80%83%E3%81%A7%E8%80%83%E3%81%88%E3%82%8B%E3%81%A8%E4%B8%8A%E6%89%8B%E3%81%8F%E3%81%84%E3%81%8F%E3%81%AE%E3%81%A7%E3%81%AF%E3%81%AA%E3%81%84%E3%81%8B%E3%80%81%E3%81%A8%E6%80%9D%E3%81%86%E3%82%88%E3%81%86%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F%E3%80%82%0A%E3%83%BB%E4%BD%95%E3%81%8C%E3%81%A9%E3%81%86%E3%81%AA%E3%82%8C%E3%81%B0%E3%82%B4%E3%83%BC%E3%83%AB%E3%81%AA%E3%81%AE%E3%81%8B%EF%BC%9F%0A%E3%83%BB%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6%E3%81%A8%E5%88%B6%E7%B4%84%E4%BA%8B%E9%A0%85%E3%81%AF%E4%BD%95%E3%81%8B%EF%BC%9F%0A%E3%83%BB%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6%E3%82%92%E7%B6%B2%E7%BE%85%E3%81%99%E3%82%8B%E3%81%9F%E3%82%81%E3%81%AB%E4%BD%95%E3%81%8C%E5%BF%85%E8%A6%81%E3%81%8B%EF%BC%9F%0A%E3%83%BB%E3%82%82%E3%81%97%E5%88%B6%E7%B4%84%E4%BA%8B%E9%A0%85%E3%82%92%E4%B8%80%E9%83%A8+%23%E4%BB%8A%E6%97%A5%E3%81%AE%E6%8C%AF%E3%82%8A%E8%BF%94%E3%82%8A&related=note_PR",
		"note_url": "https://note.com/fuji1080/n/n1844603fb2e7",
		"twitter_related_accounts": "note_PR",
		"tweet_text": "仕事や私生活が上手く進まないとき、数学的思考で考えると上手くいくのではないか、と思うようになった。\n・何がどうなればゴールなのか？\n・前提条件と制約事項は何か？\n・前提条件を網羅するために何が必要か？\n・もし制約事項を一部 #今日の振り返り",
		"circle_plans": [],
		"is_public_membership_connected": false,
		"is_board_disabled": false,
		"discount_campaigns": [],
		"lead_form": null,
		"line_add_friend": null,
		"line_add_friend_note_enable_feature": false,
		"line_add_friend_access_token": null,
		"workreq_setting": null,
		"note_share_total_count": 0,
		"note_share_provider_details": {},
		"is_published_preview_note": false,
		"is_ratable": false,
		"content_rating_via": "",
		"content_raters": [],
		"my_rating_exists": false,
		"rater_count": 0,
		"is_recently_purchased": false,
		"requires_login_for_purchase": true,
		"is_recently_tip": false,
		"exclude_from_creator_top": false,
		"exclude_ai_learning_reward": false,
		"is_related_with_investment": false,
		"related_stocks": []
	}
}

特定の記事に対する「いいね」情報

記事に対して「いいね」をくれたクリエイター情報とタイムスタンプが得られる。

https://note.com/api/v3/notes/{記事ID}/likes

{記事ID}に以下記事のIDを指定した結果はこちら。

{
	"data": {
		"likes": [
			{
				"created_at": "2025-05-22T23:39:51.000+09:00",
				"user": {
					"id": 9608332,
					"key": "61112e601b0084559ae402d572ffad02",
					"nickname": "おっくん",
					"urlname": "okkunote",
					"profile": "『素直な心』をモットーに、組織開発・リーダーシップ・コーチングを学び実践中の現役管理職\n\n学生時代に自身のノートが『おくノート』と呼ばれていてた経験を生かし、noteで小さなヒントを発信します",
					"is_no_urlname_user": false,
					"original_header_image_url": null,
					"header_image_url": null,
					"user_profile_image_url": "https://assets.st-note.com/production/uploads/images/173873147/profile_081658085663d3194963b15e926281e5.png?fit=bounds&format=jpeg&quality=85&width=330",
					"is_me": false,
					"follower_count": 86,
					"custom_domain": null,
					"followings": {
						"actively": false,
						"passively": false
					}
				}
			},
			{
				"created_at": "2025-05-11T12:18:54.000+09:00",
				"user": {
					"id": 4093782,
					"key": "299da780b1ea4cab14c61e8b0069fc59",
					"nickname": "自動化くん",
					"urlname": "kira_se",
					"profile": "Powered by Python.\ncommunity ▶︎ https://discord.gg/WHebANp37x",
					"is_no_urlname_user": false,
					"original_header_image_url": "https://assets.st-note.com/production/uploads/images/145695551/ae1a873e695170b7683dea04884f479e.jpg",
					"header_image_url": "https://assets.st-note.com/production/uploads/images/145695551/wallpaper_landscape_ae1a873e695170b7683dea04884f479e.jpg",
					"user_profile_image_url": "https://assets.st-note.com/production/uploads/images/164848573/profile_602b13c6fefeaaa858c7c53c4ce13c94.png?fit=bounds&format=jpeg&quality=85&width=330",
					"is_me": false,
					"follower_count": 2505,
					"custom_domain": null,
					"followings": {
						"actively": false,
						"passively": false
					}
				}
			},
			{
				"created_at": "2025-05-11T11:30:42.000+09:00",
				"user": {
					"id": 6984930,
					"key": "80a4dba2808d9923fde6626410d91234",
					"nickname": "ブオナローティ",
					"urlname": "fuji1080",
					"profile": "神奈川在住のITエンジニア。2児の父。",
					"is_no_urlname_user": false,
					"original_header_image_url": null,
					"header_image_url": null,
					"user_profile_image_url": "https://assets.st-note.com/production/uploads/images/177877668/profile_2881984a0bf64ccfe76742c0e0d7aa25.png?fit=bounds&format=jpeg&quality=85&width=330",
					"is_me": true,
					"follower_count": 2,
					"custom_domain": null,
					"followings": {
						"actively": false,
						"passively": false
					}
				}
			}
		],
		"extra_fields": {
			"is_liked_by_current_user": true,
			"like_count": 3
		}
	},
	"is_last_page": true
}

ハッシュタグ情報

ハッシュタグ一覧を取得

ハッシュタグのタグ名と、ハッシュタグが使用されている記事数を一覧取得できる。

https://note.com/api/v2/hashtags

ただし、ハッシュタグは相当数あるため、1回のAPI呼び出しで全件を取得することはできない。
そのため、クエリ文字列pageにページ数（1始まり）を指定することで、一覧情報を段階的に取得する形となる。
またsizeに数値を指定することで、取得するハッシュタグ情報数の上限を指定できる。

https://note.com/api/v2/hashtags?page=1&size=10

{
	"data": {
		"contents": [
			{
				"id": 594,
				"name": "#エッセイ",
				"count": 1764229,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": [
					"dce2611ed433ccdcba7372a45e90586e"
				]
			},
			{
				"id": 353462,
				"name": "#毎日note",
				"count": 1530534,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": []
			},
			{
				"id": 370,
				"name": "#写真",
				"count": 1485578,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": [
					"dce2611ed433ccdcba7372a45e90586e"
				]
			},
			{
				"id": 375,
				"name": "#小説",
				"count": 1027485,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": [
					"dce2611ed433ccdcba7372a45e90586e"
				]
			},
			{
				"id": 317381,
				"name": "#競艇予想屋",
				"count": 974503,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": [
					"1c46748f33f3319b8754539fcc09b09a"
				]
			},
			{
				"id": 559,
				"name": "#イラスト",
				"count": 952050,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": [
					"dce2611ed433ccdcba7372a45e90586e"
				]
			},
			{
				"id": 211272,
				"name": "#ボートレース予想",
				"count": 842959,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": [
					"3fb61b1ea98f9b830b9c8761541704c7"
				]
			},
			{
				"id": 220726,
				"name": "#競輪予想",
				"count": 725288,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": []
			},
			{
				"id": 372,
				"name": "#note",
				"count": 684440,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": []
			},
			{
				"id": 396,
				"name": "#自分",
				"count": 650413,
				"relatedHashtags": [],
				"relatedContests": [],
				"layoutInfraSectionKeys": []
			}
		],
		"isLastPage": false,
		"totalCount": 0
	}
}

特定のハッシュタグ情報を取得

ハッシュタグ名を指定することで、そのハッシュタグ情報や、関連する他のハッシュタグ情報を取得できる。
なお、{ハッシュタグ名}にハッシュ記号（#）は指定不要。

https://note.com/api/v2/hashtags/{ハッシュタグ名}

{ハッシュタグ名}にAIを指定した場合の出力結果は以下となる。

{
	"data": {
		"id": 30875,
		"name": "#AI",
		"count": 444159,
		"relatedHashtags": [
			{
				"name": "#ChatGPT",
				"count": 178983
			},
			{
				"name": "#生成AI",
				"count": 115541
			},
			{
				"name": "#AIとやってみた",
				"count": 89983
			},
			{
				"name": "#ビジネス",
				"count": 393780
			},
			{
				"name": "#IT",
				"count": 55471
			},
			{
				"name": "#人工知能",
				"count": 200271
			}
		],
		"relatedContests": [],
		"layoutInfraSectionKeys": []
	}
}

参考にした記事

執筆にあたり、以下記事を参考にさせていただきました。
ありがとうございます！


いいなと思ったら応援しよう！

この記事が参加している募集

#

今日の振り返り

12万件