API - Revision history

Nasu: /* Gallery Metadata Specification */

2026-02-01T12:25:22Z

Gallery Metadata Specification

← Older revision		Revision as of 12:25, 1 February 2026
Line 135:		Line 135:
	==Gallery Metadata Specification==		==Gallery Metadata Specification==
	*'''token'''		*'''token'''
	*'''archiver_key''' - [[Archiver]] keys change every hour, but an individual key is good for up to 24 hours.
	*''category'' - [[Category]] names differ slightly from the ones used on the actual site. The following are how they are called in the API:		*''category'' - [[Category]] names differ slightly from the ones used on the actual site. The following are how they are called in the API:
	** Doujinshi		** Doujinshi

Nasu at 12:23, 1 February 2026

2026-02-01T12:23:35Z

← Older revision		Revision as of 12:23, 1 February 2026
Line 30:		Line 30:
	"gid": 2231376,		"gid": 2231376,
	"token": "a7584a5932",		"token": "a7584a5932",
	~~"archiver_key": "459562--7e27d313c50099214fde6bf74f8014d9309a2bb8",~~
	"title": "[Gentsuki] Kininaru Danshi ni 〇〇 suru Onnanoko. [Color Ban] [Ongoing]",		"title": "[Gentsuki] Kininaru Danshi ni 〇〇 suru Onnanoko. [Color Ban] [Ongoing]",
	"title_jpn": "[ゲンツキ] 気になる男子に〇〇する女の子。【カラー版】 [進行中]",		"title_jpn": "[ゲンツキ] 気になる男子に〇〇する女の子。【カラー版】 [進行中]",
	"category": "Artist CG",		"category": "Artist CG",
	"thumb": "https://ehgt.org/1f/f5/1ff5e361bbf7eaa235e9560dc5d12e624959e9e7-2722367-1882-3000-~~jpg_l~~.jpg",		"thumb": "https://ehgt.org/1f/f5/1ff5e361bbf7eaa235e9560dc5d12e624959e9e7-2722367-1882-3000-jpg_250.jpg",
	"uploader": "Pokom",		"uploader": "Pokom",
	"posted": "1653702810",		"posted": "1653702810",
Line 40:		Line 39:
	"filesize": 419547090,		"filesize": 419547090,
	"expunged": false,		"expunged": false,
	"rating": "4.78",		"rating": "4.68",
	"torrentcount": "2",		"torrentcount": "5",
	"torrents": [		"torrents": [
	{		{
Line 51:		Line 50:
	},		},
	{		{
	"hash": "~~62c960eb1c7a0e00dc2933a0c83dd43e2e6ebd48~~",		"hash": "8e335d09dcb6600bb5bc18eb636bc84cb89703a2",
	"added": "~~1639495362~~",		"added": "1645552636",
	"name": "[~~Artist CG~~] Gentsuki - Kininaru Danshi ni 〇〇 suru Onnanoko ~~(14 December 2021)~~.zip",		"name": "[Gentsuki] Kininaru Danshi ni 〇〇 suru Onnanoko. [Color Ban] [Ongoing][02_22_2022].zip",
	"tsize": "~~27652~~",		"tsize": "75407",
	"fsize": "~~357426803~~"		"fsize": "376744038"
			},
			{
			"hash": "3d80a6c39da7e48469ad4701a3237da00b28b4e8",
			"added": "1650280574",
			"name": "[ゲンツキ] 気になる男子に〇〇する女の子。【カラー版】 [18-04-2022].zip",
			"tsize": "30655",
			"fsize": "394442926"
			},
			{
			"hash": "221771fd520fa9e44bb3714465c2728db68fae28",
			"added": "1678643294",
			"name": "[2023-01-31][Gentsuki] Kininaru Danshi ni 〇〇 suru Onnanoko. [Color Ban] [Ongoing].zip",
			"tsize": "21836",
			"fsize": "562301224"
			},
			{
			"hash": "1f7e0a0ac7055bf36e7d8c29c9290ba47a2498ea",
			"added": "1716203184",
			"name": "[ゲンツキ] 気になる男子に〇〇する女の子。【カラー版】 [進行中].zip",
			"tsize": "31021",
			"fsize": "802265287"
	}		}
	],		],
	"tags": [		"tags": [
			"parody:original",
	"artist:gentsuki",		"artist:gentsuki",
			"female:pantyhose",
	"female:ponytail",		"female:ponytail",
	"female:schoolgirl uniform",		"female:schoolgirl uniform",
Line 65:		Line 87:
	"female:swimsuit",		"female:swimsuit",
	"female:tanlines",		"female:tanlines",
			"female:tomboy",
	"female:twintails",		"female:twintails",
			"other:mosaic censorship",
	"other:no penetration",		"other:no penetration",
	"other:nudity only"		"other:nudity only"
Line 71:		Line 95:
	"parent_gid": "2197090",		"parent_gid": "2197090",
	"parent_key": "2f440c5f01",		"parent_key": "2f440c5f01",
			"current_gid": "2924387",
			"current_key": "aa28f4a72a",
	"first_gid": "2043548",		"first_gid": "2043548",
	"first_key": "bdb0cd9ec2"		"first_key": "bdb0cd9ec2"

Nasu: /* Gallery Metadata */ parent and first gallery info, new example

2022-06-05T10:35:50Z

Gallery Metadata: parent and first gallery info, new example

@@ Line 14: / Line 14: @@
 <pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"><nowiki>https://e-hentai.org/g/{gallery_id}/{gallery_token}/</nowiki></pre>
-Example: https://e-hentai.org/g/1881268/38609c3c06/ would require the following request:
+Example: https://e-hentai.org/g/2231376/a7584a5932/ would require the following request:
 <pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">{
    "method": "gdata",
    "gidlist": [
-       [1881268,"38609c3c06"]
+       [2231376,"a7584a5932"]
    ],
    "namespace": 1
@@ Line 26: / Line 26: @@
 Which gives the following JSON payload in response:
 <pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"><nowiki>{
-  "gmetadata": [
+    "gmetadata": [
+         {
-          "hash": "3c6a55f5362e9134a1baeb28f08ed3b3cd612c0a",
+            "gid": 2231376,
-          "added": "1617415386",
+            "token": "a7584a5932",
-          "name": "(コミティア127) [午前の紅茶。 (べにこ)] COCKTAILBOOK vol.3 (オリジナル).zip",
+            "archiver_key": "459562--7e27d313c50099214fde6bf74f8014d9309a2bb8",
-          "tsize": "15221",
+            "title": "[Gentsuki] Kininaru Danshi ni 〇〇 suru Onnanoko. [Color Ban] [Ongoing]",
-          "fsize": "194489393"
+            "title_jpn": "[ゲンツキ] 気になる男子に〇〇する女の子。【カラー版】 [進行中]",
+         }
-      ],
 }</nowiki></pre>
 If an invalid token is specified its entry in the ''gmetadata'' array will consist of the following:
 <pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">{
-   "gid":519325,
+   "gid":2231376,
    "error":"Key missing, or incorrect key provided."
 }</pre>

Blue penguin: Stop the thumb element from being interpreted as an image on FF

2021-06-19T17:38:11Z

Stop the thumb element from being interpreted as an image on FF

← Older revision		Revision as of 17:38, 19 June 2021
Line 25:		Line 25:

	Which gives the following JSON payload in response:		Which gives the following JSON payload in response:
	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">{		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>{
	"gmetadata": [		"gmetadata": [
	{		{
Line 59:		Line 59:
	}		}
	]		]
	}</pre>		}</nowiki></pre>

	If an invalid token is specified its entry in the ''gmetadata'' array will consist of the following:		If an invalid token is specified its entry in the ''gmetadata'' array will consist of the following:

Nasu: /* Gallery Metadata */

2021-04-05T13:32:52Z

Gallery Metadata

← Older revision		Revision as of 13:32, 5 April 2021
Line 14:		Line 14:
	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>https://e-hentai.org/g/{gallery_id}/{gallery_token}/</nowiki></pre>		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>https://e-hentai.org/g/{gallery_id}/{gallery_token}/</nowiki></pre>

	Example: https://e-hentai.org/g/~~618395~~/~~0439fa3666~~/ would require the following request:		Example: https://e-hentai.org/g/1881268/38609c3c06/ would require the following request:

	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">{		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">{
	"method": "gdata",		"method": "gdata",
	"gidlist": [		"gidlist": [
	[~~618395~~,"~~0439fa3666~~"]		[1881268,"38609c3c06"]
	],		],
	"namespace": 1		"namespace": 1
Line 26:		Line 26:
	Which gives the following JSON payload in response:		Which gives the following JSON payload in response:
	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">{		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">{
	"gmetadata": [		"gmetadata": [
	{		{
	"gid": ~~618395~~,		"gid": 1881268,
	"token": "~~0439fa3666~~",		"token": "38609c3c06",
	"archiver_key": "~~403565~~--~~d887c6dfe8aae79ed0071551aa1bafeb4a5ee361~~",		"archiver_key": "449341--7600994b44ff1b093bc93063d26080eb125d735c",
	"title": "(~~Kouroumu 8~~) [~~Handful☆Happiness!~~ (~~Fuyuki Nanahara~~)] ~~TOUHOU GUNMANIA A2 (Touhou Project)~~",		"title": "(COMITIA127) [morning tea. (Beniko)] Cocktail Book vol.3",
	"title_jpn": "(~~紅楼夢8~~) [~~Handful☆Happiness!~~ (~~七原冬雪~~)] ~~TOUHOU GUNMANIA A2 (東方Project)~~",		"title_jpn": "(コミティア127) [午前の紅茶。 (べにこ)] COCKTAILBOOK vol.3",
	"category": "Non-H",		"category": "Non-H",
	"thumb": "~~<nowiki>~~https://ehgt.org/14/63/~~1463dfbc16847c9ebef92c46a90e21ca881b2a12~~-~~1729712~~-~~4271~~-~~6032~~-~~jpg_l~~.jpg~~</nowiki>~~",		"thumb": "https://ehgt.org/ad/41/ad41501a46611af0ed23d594ed49dd9e7b271a29-16176016-3492-4761-png_l.jpg",
	"uploader": "~~avexotsukaai~~",		"uploader": "Concord_e",
	"posted": "~~1376143500~~",		"posted": "1617414996",
	"filecount": "20",		"filecount": "12",
	"filesize": ~~51210504~~,		"filesize": 194481976,
	"expunged": false,		"expunged": false,
	"rating": "4.43",		"rating": "4.48",
	"torrentcount": "0",		"torrentcount": "1",
	"~~tags~~": [		"torrents": [
	"~~parody~~:~~touhou project~~",		{
	"~~group~~:~~handful happiness~~",		"hash": "3c6a55f5362e9134a1baeb28f08ed3b3cd612c0a",
	"artist:~~nanahara fuyuki~~",		"added": "1617415386",
	"full color",		"name": "(コミティア127) [午前の紅茶。 (べにこ)] COCKTAILBOOK vol.3 (オリジナル).zip",
	"~~artbook~~"		"tsize": "15221",
	]		"fsize": "194489393"
	}		}
	]		],
			"tags": [
			"artist:ebihara beniko",
			"artbook",
			"full color",
			"morning tea."
			]
			}
			]
	}</pre>		}</pre>

Maximum Joe: /* Gallery Metadata Specification */

2019-03-21T03:03:39Z

Gallery Metadata Specification

← Older revision		Revision as of 03:03, 21 March 2019
Line 89:		Line 89:
	** Doujinshi		** Doujinshi
	** Manga		** Manga
	** Artist CG ~~Sets~~		** Artist CG
	** Game CG ~~Sets~~		** Game CG
	** Western		** Western
	** Image ~~Sets~~		** Image Set
	** Non-H		** Non-H
	** Cosplay		** Cosplay

Maximum Joe: /* Basics */

2017-02-25T21:20:49Z

Basics

← Older revision		Revision as of 21:20, 25 February 2017
Line 2:		Line 2:

	==Basics==		==Basics==
	*API URL: https://e-hentai.org/api.php		*API URL: https://api.e-hentai.org/api.php
	*Request method: POST		*Request method: POST
	*Request type: JSON		*Request type: JSON

Mechafujoshi: /* Gallery Metadata */

2017-01-25T13:27:49Z

Gallery Metadata

← Older revision		Revision as of 13:27, 25 January 2017
Line 12:		Line 12:
	Users must provide a gallery ID along with its token in order to retrieve metadata. Both of these can be found in a gallery's URL which has the following format:		Users must provide a gallery ID along with its token in order to retrieve metadata. Both of these can be found in a gallery's URL which has the following format:

	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">https://e-hentai.org/g/{gallery_id}/{gallery_token}/</pre>		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>https://e-hentai.org/g/{gallery_id}/{gallery_token}/</nowiki></pre>

	Example: https://e-hentai.org/g/618395/0439fa3666/ would require the following request:		Example: https://e-hentai.org/g/618395/0439fa3666/ would require the following request:

Mechafujoshi at 13:22, 25 January 2017

2017-01-25T13:22:44Z

← Older revision		Revision as of 13:22, 25 January 2017
Line 2:		Line 2:

	==Basics==		==Basics==
	*API URL: ~~http~~://g.e-hentai.org/api.php		*API URL: https://e-hentai.org/api.php
	*Request method: POST		*Request method: POST
	*Request type: JSON		*Request type: JSON
Line 12:		Line 12:
	Users must provide a gallery ID along with its token in order to retrieve metadata. Both of these can be found in a gallery's URL which has the following format:		Users must provide a gallery ID along with its token in order to retrieve metadata. Both of these can be found in a gallery's URL which has the following format:

	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">~~http~~://g.e-hentai.org/g/{gallery_id}/{gallery_token}/</pre>		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">https://e-hentai.org/g/{gallery_id}/{gallery_token}/</pre>

	Example: ~~http~~://g.e-hentai.org/g/618395/0439fa3666/ would require the following request:		Example: https://e-hentai.org/g/618395/0439fa3666/ would require the following request:

	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">{		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">{
Line 34:		Line 34:
	"title_jpn": "(紅楼夢8) [Handful☆Happiness! (七原冬雪)] TOUHOU GUNMANIA A2 (東方Project)",		"title_jpn": "(紅楼夢8) [Handful☆Happiness! (七原冬雪)] TOUHOU GUNMANIA A2 (東方Project)",
	"category": "Non-H",		"category": "Non-H",
	"thumb": "<nowiki>~~http~~://~~gt1.~~ehgt.org/14/63/1463dfbc16847c9ebef92c46a90e21ca881b2a12-1729712-4271-6032-jpg_l.jpg</nowiki>",		"thumb": "<nowiki>https://ehgt.org/14/63/1463dfbc16847c9ebef92c46a90e21ca881b2a12-1729712-4271-6032-jpg_l.jpg</nowiki>",
	"uploader": "avexotsukaai",		"uploader": "avexotsukaai",
	"posted": "1376143500",		"posted": "1376143500",
Line 61:		Line 61:
	===Gallery Tokens===		===Gallery Tokens===
	Individual page links cannot be used directly for requesting gallery metadata; they contain the gallery ID but not the token. The ''gtoken'' method can be used to find the gallery token by providing the page data from the link. Page links use the following format:		Individual page links cannot be used directly for requesting gallery metadata; they contain the gallery ID but not the token. The ''gtoken'' method can be used to find the gallery token by providing the page data from the link. Page links use the following format:
	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>~~http~~://g.e-hentai.org/s/{page_token}/{gallery_id}-{pagenumber}</nowiki></pre>		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}"><nowiki>https://e-hentai.org/s/{page_token}/{gallery_id}-{pagenumber}</nowiki></pre>

	Example: ~~http~~://g.e-hentai.org/s/40bc07a79a/618395-11 would require the following request:		Example: https://e-hentai.org/s/40bc07a79a/618395-11 would require the following request:
	<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">{		<pre<includeonly></includeonly> style="overflow: auto;{{{style\|}}}">{
	"method": "gtoken",		"method": "gtoken",

Maximum Joe: /* See also */

2016-01-15T16:42:20Z

← Older revision		Revision as of 16:42, 15 January 2016
Line 106:		Line 106:

	==See also==		==See also==
	*[~~http~~://forums.e-hentai.org/index.php?showtopic=157779 Gallery Filecount] - A userscript that uses API requests to add information to search results		*[https://forums.e-hentai.org/index.php?showtopic=157779 Gallery Filecount] - A userscript that uses API requests to add information to search results

	{{EHGNav}}		{{EHGNav}}

	[[Category:E-Hentai Galleries]]		[[Category:E-Hentai Galleries]]