{ "openapi": "3.0.1", "info": { "title": "note.com Hashtag Scraper: Articles & Creators", "description": "Scrape note.com hashtag pages into rows: article title, URL, price, paywall flag, likes, comments, publish date and creator (name, urlname, X handle, custom domain). Optional details add body text, categories, follower counts and public links. Japan residential proxy built in. Unofficial.", "version": "0.1", "x-build-id": "xgg0BdhTDaFVtqTef" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~note-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-note-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/reventadata~note-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-note-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/reventadata~note-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-note-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "hashtags" ], "properties": { "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags to read, one per line, as written on note.com: `AI`, `#日記`, or a tag URL such as `https://note.com/tag/ChatGPT`. Each tag page lists 20 (search list) or about 40-50 (timeline list) articles; `mode` adds the newest list.", "items": { "type": "string" } }, "mode": { "title": "List", "enum": [ "both", "popular", "new" ], "type": "string", "description": "Which tag list to read: `popular` (the tag page as it opens), `new` (`?mode=new`, newest first), or `both` (two pages per tag, duplicates removed).", "default": "both" }, "includeDetails": { "title": "Fetch each article page", "type": "boolean", "description": "One extra request per article: the readable text and HTML (the whole article when free, the part above the paywall when paid), paywalled character count, categories, and the creator's profile fields (followers, following, note count, bio, X handle, external links and URLs written in the bio or article).", "default": false }, "expandRelatedTags": { "title": "Also read related tags", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many of the related keywords each seed tag's page (popular and, with `mode: both`, newest) lists (up to 10) are also read, to get past the 20-47 articles one tag page shows. 0 reads only the tags given.", "default": 0 }, "maxItems": { "title": "Maximum articles", "minimum": 1, "type": "integer", "description": "Stop after this many rows.", "default": 200 }, "keywords": { "title": "Keep only articles containing", "type": "array", "description": "Case- and accent-insensitive substrings; an article is kept when any one appears in its title (or, with article pages fetched, in its text, description or the creator's bio). Empty keeps everything.", "default": [], "items": { "type": "string" } }, "excludeKeywords": { "title": "Drop articles containing", "type": "array", "description": "An article is dropped when any of these appears in the same fields.", "default": [], "items": { "type": "string" } }, "freeOnly": { "title": "Free articles only", "type": "boolean", "description": "Keep only articles the page marks free (no price and no membership gate).", "default": false }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Keep only articles with at least this many likes (the page's own count). Leave empty for no floor." }, "publishedAfter": { "title": "Published on or after", "type": "string", "description": "A date, `YYYY-MM-DD` (read as Japan time), or an ISO timestamp. Articles published before it are dropped." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Measured transport: Apify residential proxy, Japan (25/25 full pages). Without a proxy or on datacenter exits the site often answers a listing shell with no articles, which the Actor retries.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }