{ "openapi": "3.0.1", "info": { "title": "Who's Piling On? X/Bluesky Pile-on & Rumor Tracker", "description": "Who is piling on an X or Bluesky account, and who started a rumor? We read X, Bluesky, Instagram comments, Reddit, forums and the news: every account and post, sides read by a model. Instant check, full trace with a 4-stop answer card, watch names on a schedule, account lookup, evidence pack.", "version": "1.0", "x-build-id": "UdVcROutRRh2RHlPU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pressfront~pressfront-trace/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pressfront-pressfront-trace", "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/pressfront~pressfront-trace/runs": { "post": { "operationId": "runs-sync-pressfront-pressfront-trace", "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/pressfront~pressfront-trace/run-sync": { "post": { "operationId": "run-sync-pressfront-pressfront-trace", "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": [ "mode" ], "properties": { "mode": { "title": "What to do", "enum": [ "instant", "trace", "read", "understand", "watch", "evidence", "account" ], "type": "string", "description": "instant = who is posting about a name: about a second if it was traced today, otherwise Pressfront searches it now, about a minute ($0.49). trace = a fresh trace of a name, a story going around, or the situation in your own words, about 4 to 7 minutes ($4.99). read = one part of a finished trace by its id ($0.05). understand = what Pressfront would trace from your words, without starting anything ($0.05). watch = check a list of names against the last run and flag spikes; schedule it ($0.15 per name per run). evidence = the sealed evidence pack of a finished trace ($9.99, once per trace). account = which traces an account showed up in before ($0.05).", "default": "instant" }, "handle": { "title": "Name", "type": "string", "description": "An X @handle, an x.com link, or a Bluesky handle like name.bsky.social. For instant, account and trace. For trace, fill in ONE of Name, Story or Situation: the one you changed is used.", "default": "@elonmusk" }, "names": { "title": "Names to watch", "maxItems": 25, "uniqueItems": true, "type": "array", "description": "For watch: up to 25 X @handles or Bluesky handles. Every run checks each one and compares it with your last run (the last look is kept in your own key-value store named pressfront-watch). Schedule the run hourly or daily under Schedules. $0.15 per name answered, per run.", "items": { "type": "string" } }, "webhookUrl": { "title": "Webhook for spikes", "type": "string", "description": "For watch, optional: an https URL that gets one POST per run with the spike rows (only spikes) as JSON, plus a text line Slack and Discord incoming webhooks show as is. Best effort: a failed post never fails the run, the rows are in the dataset either way." }, "claim": { "title": "Story going around", "type": "string", "description": "For trace: the story people are passing around, in the few words they post it with. Words, not a link. You get the earliest public post we could find, how it spread, who carried it and whether it came round before. It shows what people posted; it never says whether the story is true." }, "text": { "title": "Situation in your own words", "type": "string", "description": "For trace and understand: what is going on, the way you would tell a friend (up to 6,000 characters). Pressfront reads it as a name or a story first. Your words are never stored." }, "traceId": { "title": "Trace id", "type": "string", "description": "From a 'trace' run's output. For read and evidence." }, "part": { "title": "Part to read", "enum": [ "case", "brief", "story", "accounts", "posts", "timeline", "groups", "who", "sites", "evidence" ], "type": "string", "description": "For read: case (the answer in four stops: who said it first, how it spread, who they are, whether it happened before), brief (plain-facts summary), story, accounts, posts, timeline, groups, who, sites or evidence (the saved posts; the sealed pack is the evidence mode). A story trace has case and brief.", "default": "brief" }, "side": { "title": "Only one side", "type": "string", "description": "For read accounts or posts: strongly_critical, mocking, disagreeing, critical, supportive, neutral or not_read." }, "sort": { "title": "Sort", "type": "string", "description": "For read accounts (followers, first, touches, newest_account) or posts (oldest, newest, followers)." }, "limit": { "title": "How many", "minimum": 1, "maximum": 200, "type": "integer", "description": "For read accounts or posts, 1 to 200." }, "cursor": { "title": "Next page", "type": "string", "description": "The 'next' value from the previous read." } } }, "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 } } } } } } } } } }