{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Competitor Benchmark", "description": "Compare 2-50 X (Twitter) accounts over the same period and see who is winning. Every row carries posts, likes, reposts, replies, views, engagement per post, share of voice and its rank in the group, plus a summary row naming the winner in each category. No X account or login needed.", "version": "0.0", "x-build-id": "JnBMzWLfFN08O1gvG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/guezi~x-competitor-benchmark/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-guezi-x-competitor-benchmark", "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-competitor-benchmark/runs": { "post": { "operationId": "runs-sync-guezi-x-competitor-benchmark", "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-competitor-benchmark/run-sync": { "post": { "operationId": "run-sync-guezi-x-competitor-benchmark", "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": "Accounts to compare", "minItems": 2, "maxItems": 50, "type": "array", "description": "Two to fifty X accounts to compare head-to-head. Paste an account name, an @name, or a link to the profile — all three work. Add your own account to see where you stand.", "items": { "type": "string" } }, "lastDays": { "title": "Compare the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "The comparison period, counting back from now. Every account is measured over exactly the same period. Ignored if you set an explicit start date below.", "default": 30 }, "postedAfter": { "title": "Period starts (optional)", "type": "string", "description": "Start of the comparison period (YYYY-MM-DD). Overrides the last-N-days setting." }, "postedBefore": { "title": "Period ends (optional)", "type": "string", "description": "End of the comparison period (YYYY-MM-DD). Defaults to now." }, "postsPerAccount": { "title": "Maximum posts measured per account", "minimum": 1, "maximum": 1000, "type": "integer", "description": "A ceiling on how many posts are measured for each account, newest first. Raise it if you compare very prolific accounts over a long period.", "default": 100 }, "includeReposts": { "title": "Count reposts as output", "type": "boolean", "description": "Off by default, so the comparison measures what each account published itself rather than what it amplified.", "default": false }, "includeReplies": { "title": "Count replies as output", "type": "boolean", "description": "Off by default. Turn it on when conversation volume is part of what you are comparing.", "default": false }, "topPostBy": { "title": "Pick each account's top post by", "enum": [ "engagement", "likes", "views", "reposts" ], "type": "string", "description": "Which metric decides the standout post reported for each account.", "default": "engagement" }, "accountsAtOnce": { "title": "Accounts collected at once", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many accounts to work through in parallel. Raise it for larger comparisons.", "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 } } } } } } } } } }