メインコンテンツへスキップ
見出し画像

【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": []
    	}
    }

    参考にした記事

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


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

    あなたへのおすすめ