{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Account Analytics", "description": "One analytics row per X (Twitter) account: average and median likes, reposts, replies and views, two engagement rates, posting frequency, best day and hour to post, content mix, top hashtags, mentions and linked sites, plus the five best posts. No X account or login needed.", "version": "0.0", "x-build-id": "uZceq1B5p6Xb29bk7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/guezi~x-account-analytics/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-guezi-x-account-analytics", "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/guezi~x-account-analytics/runs": { "post": { "operationId": "runs-sync-guezi-x-account-analytics", "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/guezi~x-account-analytics/run-sync": { "post": { "operationId": "run-sync-guezi-x-account-analytics", "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": [ "profiles" ], "properties": { "profiles": { "title": "X accounts", "type": "array", "description": "The accounts to build a report for. Paste an account name, an @name, or a link to the profile — all three work. One report row is produced per account.", "items": { "type": "string" } }, "postsToAnalyse": { "title": "Posts to analyse per account", "minimum": 10, "maximum": 2000, "type": "integer", "description": "How many recent posts each report is built from, newest first. More posts make the averages steadier; fewer make the report focus on the most recent activity.", "default": 200 }, "postedAfter": { "title": "Analyse posts published after", "type": "string", "description": "Only include posts published on or after this date (YYYY-MM-DD). Leave empty to analyse the most recent posts regardless of date." }, "postedBefore": { "title": "Analyse posts published before", "type": "string", "description": "Only include posts published on or before this date (YYYY-MM-DD). Leave empty for no upper bound." }, "includeReposts": { "title": "Count reposts", "type": "boolean", "description": "Include posts the account reposted from someone else. They count towards posting volume and the repost share. Engagement averages and the content mix are always built from the account's own posts, because a repost carries neither the numbers nor the photos, links and long text of the post it passed on.", "default": true }, "includeReplies": { "title": "Count replies", "type": "boolean", "description": "Include posts that are replies to another post. Turn this off to report only on standalone posts.", "default": true }, "accountsAtOnce": { "title": "Accounts analysed at once", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many accounts to work through in parallel. Raise it for large lists.", "default": 3 }, "countryCode": { "title": "Browse from", "enum": [ "us", "gb", "ca", "au", "de", "fr", "es", "it", "nl", "br", "mx", "in", "jp", "sg", "ae" ], "type": "string", "description": "The country to browse from. Affects which posts X shows publicly in a few regions.", "default": "us" } } }, "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 } } }, "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 } } } } } } } } } }