{
  "openapi": "3.0.1",
  "info": {
    "title": "Scribd Scraper | Documents, Authors and Views",
    "description": "Scribd scraper for public documents: search by keyword, Scribd link or document ID and get 100 documents in 34 seconds, 29 fields each. Title, author and profile, pages, word count, views, rating and votes, upload date, real language, license, file formats and table of contents. No login needed.",
    "version": "1.0",
    "x-build-id": "RvGdYYwDd9qBmrf0L"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~scribd-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-scribd-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/silentflow~scribd-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-scribd-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/silentflow~scribd-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-scribd-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": {
          "searches": {
            "title": "🔎 Keywords",
            "type": "array",
            "description": "What you would type in the Scribd search box. Each keyword is its own search and returns documents in the order Scribd ranks them. Examples: <code>business plan</code>, <code>machine learning notes</code>, <code>plan de negocios</code>, <code>service manual</code>.<br><br>Popular keywords match millions of documents: set <b>Max documents per search</b> to the number you need.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Scribd URLs",
            "type": "array",
            "description": "Paste scribd.com links, from any language site (es.scribd.com, fr.scribd.com...):<br>• a <b>document</b> link (<code>https://www.scribd.com/document/104915100/Business-Plan-Template</code>, presentation and embed links too) reads that document,<br>• a <b>search</b> link (<code>https://www.scribd.com/search?query=business%20plan</code>) runs that search with the filters you picked on the site,<br>• a <b>profile</b> link (<code>https://www.scribd.com/user/171435564/The-Business-Plan-Team</code>) reads the uploads the profile shows.<br><br>Ebooks and audiobooks are sold on Everand and are not read.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "documentIds": {
            "title": "🆔 Document IDs",
            "type": "array",
            "description": "Read documents by their Scribd ID, the number after <code>/document/</code> in the link: <code>104915100</code>, <code>86604919</code>. A full document link pasted here works too. Each ID returns one row, or is skipped when the document was removed.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Max documents per search",
            "minimum": 1,
            "type": "integer",
            "description": "The most rows each keyword, search link or profile returns. Scribd shows 40 documents per page and the run stops as soon as the number is reached.",
            "default": 100
          },
          "language": {
            "title": "🌐 Language",
            "type": "string",
            "description": "Keep documents written in one language. Leave empty for every language. Pick from the list or type a code or a name: <code>es</code>, <code>spa</code>, <code>Spanish</code> and <code>Español</code> all work."
          },
          "fileTypes": {
            "title": "📁 File types",
            "type": "array",
            "description": "Keep documents uploaded in these formats. Leave empty for every format.",
            "items": {
              "type": "string",
              "enum": [
                "pdf",
                "word",
                "epub",
                "presentation",
                "spreadsheet"
              ],
              "enumTitles": [
                "PDF",
                "Word document",
                "ePub",
                "Presentation (PowerPoint)",
                "Spreadsheet (Excel)"
              ]
            },
            "default": []
          },
          "pageRange": {
            "title": "📏 Length",
            "enum": [
              "any",
              "1-3",
              "4-100",
              "100+"
            ],
            "type": "string",
            "description": "Keep short notes, regular documents or long reference works, by number of pages.",
            "default": "any"
          },
          "uploadedWithin": {
            "title": "📅 Uploaded within",
            "enum": [
              "any",
              "1week",
              "1month",
              "3month",
              "6month",
              "1year"
            ],
            "type": "string",
            "description": "Keep documents uploaded recently. <b>Last week</b> on a keyword is a simple way to watch what gets published on a topic.",
            "default": "any"
          },
          "includeDetails": {
            "title": "📑 Full document details",
            "type": "boolean",
            "description": "On: each row also gets the real language of the document, its license, word count, file formats and sizes, topics, table of contents, translations and exact vote counts. Off: rows come from the search page only, faster, with the upload date, categories and counts the search shows. IDs, document links and profiles always get full details.",
            "default": true
          },
          "debugMode": {
            "title": "🐞 Debug mode",
            "type": "boolean",
            "description": "Write detailed logs. Leave off for normal runs.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}