{
  "openapi": "3.0.1",
  "info": {
    "title": "LLMs.txt Generator",
    "description": "The most powerful LLMs.txt Generator tool online. Generates LLMs.txt , llms-full.txt and markdown .md files within seconds! Get your website discovered, and recommended by ChatGPT, Claude, Google Gemini, Perplexity, Grok, and every AI. (Great for AEO, AIO, GEO, AI SEO) Made by Hi LLMs",
    "version": "2.0",
    "x-build-id": "OaGSALfhU2siRRcvh"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/onescales~the-llms-txt-generator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-onescales-the-llms-txt-generator",
        "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/onescales~the-llms-txt-generator/runs": {
      "post": {
        "operationId": "runs-sync-onescales-the-llms-txt-generator",
        "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/onescales~the-llms-txt-generator/run-sync": {
      "post": {
        "operationId": "run-sync-onescales-the-llms-txt-generator",
        "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": [
          "url",
          "websitename",
          "websitedescription",
          "websitecategory",
          "urlFormat"
        ],
        "properties": {
          "url": {
            "title": "URL(s): Domain, Sitemap URL or List of Pages",
            "type": "string",
            "description": "Enter one of the following:\n\n• A domain without https (e.g., apple.com or example.org) - app will find your sitemap\n• A sitemap URL (e.g., https://apple.com/sitemap.xml) - app will parse it\n• A list of specific page URLs (one per line) - app will process only those pages\n\nExamples:\napple.com\nhttps://apple.com/sitemap.xml\nhttps://apple.com/about\nhttps://apple.com/pricing"
          },
          "websitename": {
            "title": "Website/Business Name",
            "maxLength": 500,
            "type": "string",
            "description": "The name of your website or business (max 500 characters). This goes on the top of the llms.txt file."
          },
          "websitedescription": {
            "title": "Website/Business Description",
            "maxLength": 800,
            "type": "string",
            "description": "A short summary of your website or business containing key information (max 800 characters).  This goes on the top of the llms.txt file."
          },
          "websitecategory": {
            "title": "Website/Business Category",
            "enum": [
              "saas",
              "ecommerce",
              "service",
              "media/blog",
              "other"
            ],
            "type": "string",
            "description": "Select the category that best describes your website (required). This setting will help organize the llms.txt file categories.",
            "default": "other"
          },
          "maxItems": {
            "title": "Maximum Number of Pages to Process",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of pages to process (leave empty for unlimited)"
          },
          "pauseBetweenPages": {
            "title": "Pause between pages (in seconds)",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Add a delay between processing each page to avoid getting blocked or reduce server load (optional, 1-100 seconds)"
          },
          "urlFormat": {
            "title": "URL Format in llms.txt",
            "enum": [
              "original",
              "markdown"
            ],
            "type": "string",
            "description": "This setting will change the urls referenced inside the llms.txt. We strongly recommend using the Markdown URLs option and specifying the url path of where you are storing your .md markdown files from this app output.",
            "default": "markdown"
          },
          "markdownUrlPath": {
            "title": "URL Path for Markdown Files",
            "pattern": "^https?://.*",
            "type": "string",
            "description": "The URL path where you'll upload the generated .md files on your server (e.g., https://example.com/llms-content/ or https://example.com/docs/). The app will append the filename to this path. Only used when 'Markdown URLs' is selected."
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Proxy settings for the scraper (recommended to leave default)",
            "default": {
              "useApifyProxy": true
            }
          },
          "previousRunId": {
            "title": "Add to Previous llms.txt (if prior run failed)",
            "type": "string",
            "description": "Use this section ONLY IF your previous run failed and you want to retry the failed pages and merge with previous results.\n\nALL YOU HAVE TO DO:\n\n1. Take the Run ID from your previous run that failed (found in the browser URL or in the 'Run ID' column of the output table).\n2. Specify only the urls that failed.\n3. The app will rerun ONLY the URLs you specify below and merge them with all the successful pages from the previous run."
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}