{
  "openapi": "3.0.1",
  "info": {
    "title": "Taylor & Francis Online Scraper - Articles & Abstracts",
    "description": "Scrape Taylor & Francis Online: search 4,250 T&F and Routledge journals for article titles, DOIs, full author lists, abstracts, keywords, journal and issue details, view and citation counts, access status and PDF links. Abstracts included for paywalled papers. Incremental monitoring built in.",
    "version": "1.0",
    "x-build-id": "Slj1IpzYS8fAmkfGj"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/trev0n~tandfonline-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-trev0n-tandfonline-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/trev0n~tandfonline-scraper/runs": {
      "post": {
        "operationId": "runs-sync-trev0n-tandfonline-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/trev0n~tandfonline-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-trev0n-tandfonline-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": {
          "searchQuery": {
            "title": "🔍 Search query",
            "type": "string",
            "description": "What to search for across the whole record — title, abstract, keywords and full text (e.g. \"mass spectrometry\"). Leave empty if you search by title, author or journal instead."
          },
          "title": {
            "title": "📝 Words in the title",
            "type": "string",
            "description": "Only match articles with these words in the title."
          },
          "abstract": {
            "title": "📄 Words in the abstract",
            "type": "string",
            "description": "Only match articles with these words in the abstract."
          },
          "author": {
            "title": "👤 Author",
            "type": "string",
            "description": "Author name to search for (e.g. \"Smith\")."
          },
          "journalCodes": {
            "title": "📚 Journals",
            "type": "array",
            "description": "Limit the run to specific journals. Use the short code from the journal address — \"lanl20\" in tandfonline.com/journals/lanl20. Codes are checked against the list of 4,250 journals when the run starts, so a typo is reported instead of silently searching everything. With no search query this collects everything those journals published, newest first.",
            "items": {
              "type": "string"
            }
          },
          "articleType": {
            "title": "📑 Article type",
            "enum": [
              "any",
              "research-article",
              "review-article",
              "review",
              "book-review",
              "editorial",
              "brief-report",
              "rapid-communication",
              "report",
              "abstract",
              "other"
            ],
            "type": "string",
            "description": "Limit results to one kind of article.",
            "default": "any"
          },
          "yearFrom": {
            "title": "📅 Published from (year)",
            "minimum": 1700,
            "maximum": 2100,
            "type": "integer",
            "description": "Only include articles published in this year or later."
          },
          "yearTo": {
            "title": "📅 Published to (year)",
            "minimum": 1700,
            "maximum": 2100,
            "type": "integer",
            "description": "Only include articles published up to and including this year."
          },
          "sortBy": {
            "title": "↕️ Sort by",
            "enum": [
              "relevance",
              "newest",
              "oldest",
              "most-cited",
              "most-downloaded"
            ],
            "type": "string",
            "description": "Result order.",
            "default": "relevance"
          },
          "openAccessOnly": {
            "title": "🔓 Open access only",
            "type": "boolean",
            "description": "Keep only freely readable articles.",
            "default": false
          },
          "minCitations": {
            "title": "📈 Minimum citations",
            "minimum": 0,
            "type": "integer",
            "description": "Drop articles cited fewer times than this.",
            "default": 0
          },
          "includeKeywords": {
            "title": "✅ Must contain",
            "type": "array",
            "description": "Keep an article only if its title, abstract or keywords contain at least one of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "🚫 Must not contain",
            "type": "array",
            "description": "Drop articles whose title, abstract or keywords contain any of these words.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Direct URLs",
            "type": "array",
            "description": "Scrape specific Taylor & Francis addresses — search result pages, journal issue pages, article pages, or plain DOIs (10.1080/…).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxResults": {
            "title": "🔢 Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many articles. Set 0 for no limit.",
            "default": 100
          },
          "maxPagesPerSearch": {
            "title": "📑 Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Stop each search after this many result pages. 0 means no page limit — searches can run to the very last result, there is no cap.",
            "default": 0
          },
          "pageSize": {
            "title": "📦 Results per page",
            "minimum": 10,
            "maximum": 500,
            "type": "integer",
            "description": "How many articles to collect per request. Larger pages mean fewer requests; past 500 the server takes so long to render one page (75 seconds for 2000 results) that the request looks like a hang, so 500 is the ceiling and 100 is a safe default.",
            "default": 100
          },
          "includeAbstracts": {
            "title": "📄 Abstracts (recommended, cheap)",
            "type": "boolean",
            "description": "Add the abstract to every article. Abstracts are read through the site's own citation export, which answers for up to 50 articles in a single request — about 1.8 KB per article against the ~195 KB a full article page costs, and it works for paywalled articles too. Leave this on unless you only need a bibliography.",
            "default": true
          },
          "includeOpenAlexData": {
            "title": "🏷️ Keywords & topics (recommended, free)",
            "type": "boolean",
            "description": "Add author keywords and topic classifications from an open scholarly index. Free, needs no browser, and covers virtually every article published more than about a week ago — for the newest few days it may be missing, in which case turn on Full mode to read them from the article page.",
            "default": true
          },
          "includeCitationCounts": {
            "title": "📊 Exact citation counts (recommended, free)",
            "type": "boolean",
            "description": "Add exact, up-to-date citation counts plus ISSNs and page ranges from an open scholarly index. Free and needs no browser. More current than the counter printed on the website.",
            "default": true
          },
          "fetchArticlePages": {
            "title": "📖 Full mode — open each article page (page range, submission dates, view counts)",
            "type": "boolean",
            "description": "Additionally open every article's own page for the four things no other channel carries: the page range, the received/accepted dates, the view counter and the Altmetric score. Abstracts do NOT need this — they come from the lightweight request above. A full page is ~195 KB against ~1 KB, so this mode costs roughly 10× more per article, which is why it is off by default.",
            "default": false
          },
          "abstractMaxLength": {
            "title": "✂️ Abstract max length",
            "minimum": 0,
            "type": "integer",
            "description": "Trim abstracts to this many characters. 0 keeps them in full.",
            "default": 0
          },
          "crossrefMailto": {
            "title": "📧 Contact e-mail",
            "type": "string",
            "description": "Optional. A contact address sent with metadata requests to get the faster service tier."
          },
          "compact": {
            "title": "🗜️ Compact output",
            "type": "boolean",
            "description": "Emit only the essential fields (title, authors, abstract, keywords, citations, link).",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "🧹 Drop empty fields",
            "type": "boolean",
            "description": "Leave empty fields out of the records entirely.",
            "default": false
          },
          "incrementalMode": {
            "title": "🔄 Incremental monitoring",
            "type": "boolean",
            "description": "Across scheduled runs, emit only articles that are new or changed since last time. Cuts the cost of daily literature alerts by 80–95%.",
            "default": false
          },
          "stateKey": {
            "title": "🔑 Monitoring key",
            "type": "string",
            "description": "Name for this monitoring baseline. Leave empty to derive one from your search settings. Use different keys for different watch lists."
          },
          "emitUnchanged": {
            "title": "♻️ Include unchanged",
            "type": "boolean",
            "description": "Also emit articles that haven't changed since the previous run.",
            "default": false
          },
          "emitExpired": {
            "title": "🗑️ Include disappeared",
            "type": "boolean",
            "description": "Also emit articles that were in the previous run but are no longer found.",
            "default": false
          },
          "webhookUrl": {
            "title": "🔔 Webhook URL",
            "type": "string",
            "description": "POST the run results to this address when monitoring finds something."
          },
          "telegramBotToken": {
            "title": "🤖 Telegram bot token",
            "type": "string",
            "description": "Send new articles to a Telegram chat."
          },
          "telegramChatId": {
            "title": "💬 Telegram chat id",
            "type": "string",
            "description": "Chat that receives the Telegram messages."
          },
          "discordWebhookUrl": {
            "title": "🎮 Discord webhook",
            "type": "string",
            "description": "Send new articles to a Discord channel."
          },
          "slackWebhookUrl": {
            "title": "💼 Slack webhook",
            "type": "string",
            "description": "Send new articles to a Slack channel."
          },
          "notifyOnlyChanges": {
            "title": "🔕 Only notify on changes",
            "type": "boolean",
            "description": "Stay silent when a monitoring run finds nothing new.",
            "default": true
          },
          "notificationLimit": {
            "title": "📝 Items per notification",
            "minimum": 1,
            "type": "integer",
            "description": "How many articles to list in a notification message.",
            "default": 10
          },
          "includeRunSummary": {
            "title": "📈 Include run summary",
            "type": "boolean",
            "description": "Add the run statistics to webhook payloads.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "🌍 Proxy configuration",
            "type": "object",
            "description": "Proxy settings. Residential proxies are strongly recommended — Taylor & Francis is protected and refuses most datacenter addresses.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          },
          "detailsPerSession": {
            "title": "🔁 Requests per session",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Start a fresh session (new browser check, new address) after this many requests. 0 keeps one session for the whole run and only replaces it when the site refuses it — the cheapest and fastest setting.",
            "default": 0
          },
          "maxConcurrency": {
            "title": "⚡ Parallel requests",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "How many requests to run at the same time once the site's protection check has been passed. Higher is faster; 5 is a polite default and 8 is the tested maximum.",
            "default": 5
          },
          "warmupTimeoutSecs": {
            "title": "⏳ Connection warm-up timeout",
            "minimum": 30,
            "maximum": 600,
            "type": "integer",
            "description": "How long to give the browser to get through the site's protection check before trying a different address. It usually takes 10-20 seconds; raise this on slow networks.",
            "default": 120
          },
          "reuseSession": {
            "title": "♻️ Reuse the session between runs",
            "type": "boolean",
            "description": "Keep the result of the site's protection check (valid for up to a year) in a named key-value store and reuse it in the next run with the same proxy settings, so scheduled runs usually start without a browser. A refused session is replaced automatically.",
            "default": true
          },
          "maxRequestRetries": {
            "title": "🔄 Max retries",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many times to retry a refused request (each time on a fresh session and address) before giving up on it.",
            "default": 4
          },
          "headless": {
            "title": "🖥️ Headless browser",
            "type": "boolean",
            "description": "Only used with the Google Chrome option below, which Taylor & Francis refuses in headless mode. The default browser always runs headless.",
            "default": false
          },
          "browserChannel": {
            "title": "🌐 Browser",
            "enum": [
              "camoufox",
              "chrome",
              "chromium"
            ],
            "type": "string",
            "description": "Which browser passes the site's protection check. The browser is used for that check only and is closed straight after; all data is then read over plain HTTP. Google Chrome needs an image with Chrome installed and falls back to the default when it cannot start.",
            "default": "camoufox"
          },
          "debug": {
            "title": "🐞 Debug snapshots",
            "type": "boolean",
            "description": "Save page snapshots when something goes wrong, to help diagnose a failed run.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}