{ "openapi": "3.0.1", "info": { "title": "Quora Space Activity & Content Change Monitor", "description": "Monitor a Quora Space's metadata, feed and contributors, or track any public Quora question, answer, profile, topic or post for content changes between runs.", "version": "1.0", "x-build-id": "aLCrq4hY56YrC10gA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nimbryxo-studio~quora-space-activity-and-content-change-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nimbryxo-studio-quora-space-activity-and-content-change-monitor", "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/nimbryxo-studio~quora-space-activity-and-content-change-monitor/runs": { "post": { "operationId": "runs-sync-nimbryxo-studio-quora-space-activity-and-content-change-monitor", "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/nimbryxo-studio~quora-space-activity-and-content-change-monitor/run-sync": { "post": { "operationId": "run-sync-nimbryxo-studio-quora-space-activity-and-content-change-monitor", "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", "properties": { "spaceUrls": { "title": "Space URLs", "type": "array", "description": "Direct /q/ Space routes or Space subdomain URLs.", "items": { "type": "string" }, "default": [] }, "urls": { "title": "Any Quora URLs (Entity-Agnostic Monitoring)", "type": "array", "description": "Any public Quora URL (question, answer, profile, topic, or standalone post) to monitor for content-level changes (title/body changed) between runs. Space URLs are automatically routed to the richer Space-aware path below; every other Quora URL is monitored via the generic title/content-hash change mechanism. Requires stateStoreId.", "items": { "type": "string" }, "default": [] }, "startUrls": { "title": "Start URLs", "type": "array", "description": "API-compatible request objects for any public Quora URL (Space, question, answer, profile, topic, or post); auto-routed by URL shape the same way as spaceUrls/urls.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Discovery Queries", "type": "array", "description": "Native Quora search queries used for bounded Space-link and entity-link discovery evidence.", "items": { "type": "string" }, "default": [] }, "maxDiscoveryResults": { "title": "Maximum Discovered Spaces", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum Space links emitted by each query discovery row.", "default": 20 }, "includeMetadata": { "title": "Include Metadata", "type": "boolean", "description": "Emit one Space metadata row per successfully observed Space.", "default": true }, "includeFeed": { "title": "Include Feed", "type": "boolean", "description": "Emit bounded visible feed item rows.", "default": true }, "scrapeDepth": { "title": "Scrape Depth", "enum": [ "overview", "detail" ], "type": "string", "description": "Overview captures metadata/status only and disables feed, contributor, scroll, and load-more work. Detail preserves bounded monitoring traversal; it is not complete history.", "default": "detail" }, "feedTab": { "title": "Requested Feed Tab", "enum": [ "all", "posts", "questions", "top", "unanswered", "about", "rules" ], "type": "string", "description": "Requested tab; only exact visible labels are selected, and unavailable tabs produce no feed rows.", "default": "all" }, "includeContributors": { "title": "Include Contributors", "type": "boolean", "description": "Emit only contributors found inside explicitly labeled role regions.", "default": false }, "contributorRoles": { "title": "Contributor Roles", "type": "array", "description": "Role labels accepted for contributor rows.", "items": { "type": "string" }, "default": [ "owner", "moderator", "admin", "contributor" ] }, "maxFeedItems": { "title": "Maximum Feed Items", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum feed rows per Space.", "default": 50 }, "maxContributors": { "title": "Maximum Contributors", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum contributor rows per Space.", "default": 50 }, "maxFeedQuestionExpansions": { "title": "Maximum Feed Question Expansions", "minimum": 0, "maximum": 500, "type": "integer", "description": "When Scrape Depth is detail, bounded number of question-type feed items to open and expand into full question fields (question_id, question_answer_count, question_view_count, question_details, question_created_at, question_updated_at). Zero keeps the feed-digest-only behavior.", "default": 0 }, "includeFeedText": { "title": "Include Feed Text", "type": "boolean", "description": "Include visible feed text evidence.", "default": true }, "includeMedia": { "title": "Include Media", "type": "boolean", "description": "Include visible media URLs when present.", "default": false }, "includeOutboundLinks": { "title": "Include Outbound Links", "type": "boolean", "description": "Include bounded outbound links from feed cards.", "default": false }, "includeRules": { "title": "Include Rules", "type": "boolean", "description": "Include explicitly headed rules or guidelines text.", "default": true }, "includeTopics": { "title": "Include Topics", "type": "boolean", "description": "Include visible topic links.", "default": true }, "includeSettings": { "title": "Include Explicit Space Settings", "type": "boolean", "description": "Opt in to explicitly labeled public/authorized Space settings and content-permission evidence; missing settings remain not_observed and admin-only submission queues are never scraped.", "default": false }, "maxScrollAttempts": { "title": "Maximum Scroll Attempts", "minimum": 0, "maximum": 20, "type": "integer", "description": "Bounded scroll budget for visible feed traversal; termination state is reported per run.", "default": 5 }, "maxLoadMoreAttempts": { "title": "Maximum Load More Attempts", "minimum": 0, "maximum": 20, "type": "integer", "description": "Bounded attempts to activate visible feed load-more controls; click and termination state are reported.", "default": 5 }, "onlyNewItems": { "title": "Only New Items", "type": "boolean", "description": "Suppress unchanged state events when configured with a state store.", "default": false }, "includeUnchanged": { "title": "Include Unchanged", "type": "boolean", "description": "Keep unchanged event rows when onlyNewItems is enabled.", "default": true }, "stateStoreId": { "title": "State Store ID", "type": "string", "description": "Key-value store used for bounded feed/Space/generic-URL snapshots and change evidence. Required when onlyNewItems is enabled, and required whenever urls (entity-agnostic monitoring) is populated.", "default": "" }, "stateRetentionDays": { "title": "State Retention Days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Opt-in age-based pruning for unseen state snapshots; zero disables pruning.", "default": 0 }, "diffMode": { "title": "Diff Mode", "enum": [ "hash_only", "field_summary", "field_values", "hash_and_summary" ], "type": "string", "description": "Change evidence detail level.", "default": "hash_and_summary" }, "maxItems": { "title": "Maximum Output Rows", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Global output row cap; zero means no explicit cap.", "default": 0 }, "requestDelay": { "title": "Request Delay", "minimum": 0, "maximum": 30, "type": "number", "description": "Delay between source pages in seconds.", "default": 2 }, "maxConcurrency": { "title": "Maximum Concurrency", "minimum": 1, "maximum": 3, "type": "integer", "description": "Bounded number of source pages processed concurrently.", "default": 1 }, "maxNavigationRetries": { "title": "Maximum Navigation Retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "Bounded retries for transient navigation failures; retry counts and delays are reported.", "default": 2 }, "language": { "title": "Browser Language", "enum": [ "auto", "en", "es", "fr", "de", "it", "pt", "ja", "ko", "zh", "hi", "tr", "ru", "en-US", "en-GB", "de-DE", "fr-FR", "es-ES", "pt-BR", "it-IT", "ja-JP", "ko-KR", "zh-CN", "zh-TW", "hi-IN", "tr-TR", "ru-RU" ], "type": "string", "description": "Browser language hint. Short language codes and supported regional aliases are accepted and normalize to the short code; auto keeps the actor default. This does not translate content or prove access.", "default": "auto" }, "cookies": { "title": "Cookies", "type": "array", "description": "Optional user-supplied session cookies.", "items": { "type": "object" }, "default": [] }, "cookieString": { "title": "Optional Cookie Header String", "type": "string", "description": "Optional browser-exported name=value; name2=value2 header. Parsed locally into authorized session cookies; the raw header is never emitted or logged." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration. Defaults to the RESIDENTIAL proxy group, which real-world testing showed is required for reliable access to Quora's Cloudflare-protected pages (the un-grouped AUTO/datacenter tier is measurably blocked/redirected on a meaningful share of requests); the actor also forces RESIDENTIAL whenever a group is left unspecified. Choose a different group, or disable the proxy, only if you understand the reliability tradeoff.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "outputFields": { "title": "Output Fields (Optional)", "maxItems": 3000, "type": "array", "description": "Optional allowlist for compact rows, including bounded dotted paths through nested collections (for example answers.answer_text, comments.comment_text, feed.feed_text, or contributors.contributor_name where applicable). Child identity/URL fields and the actor identity, access/status, source, traversal, graph, filter, and parser-envelope fields remain protected.", "items": { "type": "string" }, "default": [] }, "includeFieldEvidence": { "title": "Include Field Evidence", "type": "boolean", "description": "Retain field_sources and fields_present after projection; disabling removes only these evidence maps.", "default": true }, "maxItemsPerSource": { "title": "Maximum Items Per Source", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum semantic records emitted from each direct URL, query, or typed source. Status and run-manifest rows are preserved. Use 0 for no per-source cap.", "default": 0 } } }, "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 } } } } } } } } } }