{
  "openapi": "3.0.1",
  "info": {
    "title": "X Community Tweets Scraper — Deep History, Filters, No Login",
    "description": "Collect public tweets from any X Community: up to 2,000 per Community, free filters (date, likes, views, language, media), keyword search across Communities, and engagement and author data. No login or cookies.",
    "version": "1.0",
    "x-build-id": "07vomauGiJeXH0ToS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~x-community-tweets-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-x-community-tweets-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/khadinakbar~x-community-tweets-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-x-community-tweets-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/khadinakbar~x-community-tweets-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-x-community-tweets-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",
        "properties": {
          "communities": {
            "title": "Community URLs or IDs",
            "maxItems": 10,
            "type": "array",
            "description": "Use this when you want tweets from specific X/Twitter Communities. Accepts a Community URL such as https://x.com/i/communities/1699807431709041070 or its numeric ID. Up to 10 Communities per run, fetched in parallel. Leave empty only if you fill in the keyword search below. This is not a profile URL, handle or hashtag field.",
            "items": {
              "type": "string"
            },
            "default": [
              "https://x.com/i/communities/1699807431709041070"
            ]
          },
          "maxTweetsPerCommunity": {
            "title": "Max tweets per Community",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Use this to set how many tweets to collect from each Community, for example 500. Range 1 to 2000, default 20. Up to 20 returns the newest tweets quickly; above 20 the Actor pages back through the Community history. You pay per tweet saved, so a lower number costs less. A Community may have fewer public tweets than you ask for.",
            "default": 20
          },
          "sinceDate": {
            "title": "Only tweets since (date)",
            "type": "string",
            "description": "Use this to keep only tweets posted on or after this date, written like 2026-11-01. Paging stops early once the history is older than this date. Leave empty for no start date."
          },
          "untilDate": {
            "title": "Only tweets until (date)",
            "type": "string",
            "description": "Use this to keep only tweets posted on or before this date (the whole day is included), written like 2026-11-10. Leave empty for no end date."
          },
          "minLikes": {
            "title": "Minimum likes",
            "minimum": 0,
            "type": "integer",
            "description": "Use this to keep only tweets with at least this many likes, for example 10 to skip low-engagement posts. 0 keeps everything.",
            "default": 0
          },
          "minViews": {
            "title": "Minimum views",
            "minimum": 0,
            "type": "integer",
            "description": "Use this to keep only tweets with at least this many views. Tweets that report no view count are skipped when this is above 0. 0 keeps everything.",
            "default": 0
          },
          "language": {
            "title": "Language code",
            "type": "string",
            "description": "Use this to keep only tweets in one language, using a short code such as en, es, pt or fr. Leave empty for all languages."
          },
          "onlyWithMedia": {
            "title": "Only tweets with images or video",
            "type": "boolean",
            "description": "Use this to keep only tweets that have an attached photo, video or GIF.",
            "default": false
          },
          "excludeReplies": {
            "title": "Skip replies",
            "type": "boolean",
            "description": "Use this to drop replies and keep only top-level posts.",
            "default": false
          },
          "searchQuery": {
            "title": "Keyword search across all Communities",
            "type": "string",
            "description": "Use this to find tweets that mention a word or phrase across all public Communities, for example ai agents. When this is filled in, the Actor searches by keyword and ignores the Community list above. Rows are saved with the same fields and the same price per tweet. Leave empty to read the Communities listed above."
          },
          "searchSort": {
            "title": "Search order",
            "enum": [
              "Latest",
              "Top"
            ],
            "type": "string",
            "description": "Use this to choose whether keyword search returns the newest tweets or the most popular ones. Only used when a keyword is set.",
            "default": "Latest"
          },
          "maxSearchTweets": {
            "title": "Max tweets for keyword search",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Use this to cap how many tweets keyword search saves in total, for example 200. Range 1 to 2000, default 100. Only used when a keyword is set.",
            "default": 100
          },
          "includeCommunityDetails": {
            "title": "Add Community name and size to each row",
            "type": "boolean",
            "description": "Use this to add the Community name, description and member count to every tweet row (one extra lookup per Community, no extra charge). Skipped on runs of 10 tweets or fewer. Turn it off for slimmer rows.",
            "default": true
          },
          "deduplicateTweets": {
            "title": "Remove duplicate tweets",
            "type": "boolean",
            "description": "Use this to avoid saving the same tweet twice when Communities or pages overlap. Compares the tweet ID within this run. Turn it off only if you need every occurrence.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}