{
  "openapi": "3.1.0",
  "info": {
    "title": "CULT+MATH paid runs",
    "version": "1.0.0",
    "description": "Fresh, citable measurements an agent pays for per run over the Machine Payments Protocol (HTTP 402, Stripe shared payment tokens). The free research, the Decision Briefs and the MCP server are described at https://cultmath.com/llms.txt.",
    "contact": {
      "name": "CULT+MATH",
      "url": "https://cultmath.com",
      "email": "ipalibo@cultmath.com"
    }
  },
  "servers": [
    {
      "url": "https://cultmath.com"
    }
  ],
  "x-service-info": {
    "categories": [
      "research",
      "data"
    ],
    "docs": {
      "homepage": "https://cultmath.com",
      "llms": "https://cultmath.com/llms.txt",
      "apiReference": "https://cultmath.com/openapi.json"
    }
  },
  "paths": {
    "/run/filing-trend": {
      "post": {
        "operationId": "runFilingTrend",
        "summary": "Share of U.S. 10-K filers that mention a phrase, by year, from SEC EDGAR full-text search, with controls",
        "description": "Counts 10-K filings mentioning the phrase each year and reports each count as a share of filers, using \"competition\" as the denominator. A null control (\"shrinkflation\") must return 0. The run executes before the charge: if a control fails, the answer is 422 and nothing is charged. Limits, stated on every result: it counts filings, not companies; a mention is not a meaning; the current year is incomplete; counts over 10,000 are floors. Parameters may also be sent as query parameters (the payment URL from the MCP tool run_filing_trend carries them).",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH filing-trend run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phrase"
                ],
                "properties": {
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80,
                    "description": "The phrase to count, without quote marks."
                  },
                  "start": {
                    "type": "integer",
                    "minimum": 2001,
                    "description": "First year. Default: four years ago."
                  },
                  "end": {
                    "type": "integer",
                    "description": "Last year, not in the future. Default: this year. At most 10 years per run."
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "phrase": "tariff",
                "start": 2021,
                "end": 2025
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: by-year counts, denominator and share; both controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "SEC EDGAR could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: share by year (start-end)",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/regulatory-trend": {
      "post": {
        "operationId": "runRegulatoryTrend",
        "summary": "Share of U.S. federal final and proposed rules that mention a phrase, by year, from the Federal Register, with controls",
        "description": "Counts final and proposed rules mentioning the phrase each year (optionally for one agency) and reports each count as a share of all final and proposed rules that year. A null control (a string no document contains) must return 0 across the window. The run executes before the charge: if a control fails, the answer is 422 and nothing is charged. Limits, stated on every result: it counts documents, not rulemakings; a mention is not applicability; notices are excluded; wording matters; the current year is incomplete; counts of 10,000 or more are floors. Parameters may also be sent as query parameters (the payment URL from the MCP tool run_regulatory_trend carries them). Switched on separately from the filing-trend run: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH regulatory-trend run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phrase"
                ],
                "properties": {
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80,
                    "description": "The phrase to count, without quote marks."
                  },
                  "start": {
                    "type": "integer",
                    "minimum": 1994,
                    "description": "First year. Default: four years ago."
                  },
                  "end": {
                    "type": "integer",
                    "description": "Last year, not in the future. Default: this year. At most 10 years per run."
                  },
                  "agency": {
                    "type": "string",
                    "enum": [
                      "fda",
                      "usda",
                      "ftc",
                      "epa",
                      "cpsc",
                      "fcc",
                      "sec",
                      "dol",
                      "treasury"
                    ],
                    "description": "Optional: one agency's rules only."
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "phrase": "front-of-package",
                "start": 2021,
                "end": 2025,
                "agency": "fda"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: by-year counts, denominator and share; the null control; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The Federal Register API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: share by year",
          "compare": null,
          "place": null,
          "segment": "agency narrows to one regulator"
        }
      }
    },
    "/run/spend-trend": {
      "post": {
        "operationId": "runSpendTrend",
        "summary": "Share of U.S. federal prime contract obligations matching a keyword, by federal fiscal year, from USAspending, with controls",
        "description": "Contract obligations matching the keyword each fiscal year as a share of all prime contract obligations. A null control (a string no award contains) must match $0. The run executes before the charge; a failed control is a 422 and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH spend-trend run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phrase"
                ],
                "properties": {
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80,
                    "description": "The phrase to measure, without quote marks."
                  },
                  "start": {
                    "type": "integer",
                    "minimum": 2008
                  },
                  "end": {
                    "type": "integer"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "phrase": "cybersecurity",
                "start": 2021,
                "end": 2025
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: by-year counts, denominator and share; both controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "USAspending could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: share by fiscal year (start-end)",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/triangulation": {
      "post": {
        "operationId": "runTriangulation",
        "summary": "One phrase in 10-K filings, federal rules and federal contract spending at once, with every source’s controls",
        "description": "Runs the filing-trend, regulatory-trend and spend-trend measurements on the same phrase and years (at most 5), side by side, with the direction of each line and whether they agree. If any source fails its controls the run is unsound: 422, nothing charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH triangulation run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phrase"
                ],
                "properties": {
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80,
                    "description": "The phrase to measure, without quote marks."
                  },
                  "start": {
                    "type": "integer",
                    "minimum": 2008
                  },
                  "end": {
                    "type": "integer"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "phrase": "PFAS",
                "start": 2021,
                "end": 2025
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: by-year counts, denominator and share; both controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: three shares by year (start-end)",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/peer-benchmark": {
      "post": {
        "operationId": "runPeerBenchmark",
        "summary": "One company’s filed metric against 2-6 peers, latest fiscal year, from SEC EDGAR XBRL, with controls",
        "description": "Revenue growth, gross margin, or R&D or sales-and-marketing as a share of revenue, for a company and its peers from a verified list. Identity, freshness, fiscal-year alignment and plausibility controls; exclusions are named. Unsound runs (no value for the company, or fewer than 2 peers left) are a 422 and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH peer-benchmark run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ticker",
                  "peers",
                  "metric"
                ],
                "properties": {
                  "ticker": {
                    "type": "string"
                  },
                  "peers": {
                    "type": "string",
                    "description": "2-6 tickers, comma-separated"
                  },
                  "metric": {
                    "type": "string",
                    "enum": [
                      "revenue_growth",
                      "gross_margin",
                      "rd_intensity",
                      "sm_intensity",
                      "ad_intensity"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "ticker": "GIS",
                "peers": "CAG,CPB,KHC",
                "metric": "gross_margin"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: by-year counts, denominator and share; both controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "SEC EDGAR could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "latest fiscal year only",
          "compare": "peers (the comparison set)",
          "place": null,
          "segment": "metric (growth, margin, R&D, S&M, ad intensity)"
        }
      }
    },
    "/run/ai-visibility": {
      "post": {
        "operationId": "runAiVisibility",
        "summary": "Is a domain cited when four AI platforms answer a buyer’s question, and does it hold? A derived measurement, not the answers",
        "description": "Asks ChatGPT, Claude, Gemini and Perplexity the question live with web search on: three times each on the everyday model and once on the flagship model, 16 answers. Returns per platform in how many askings the domain was cited and at what positions, whether that held every time, and whether the flagship model agrees; how many platforms cite it; and the other domains cited most, as counts of answers. The answers, URLs and titles are not returned. A platform is measured when at least 2 of its 3 everyday askings answered with sources; fewer than 3 platforms measured is unsound: 422, nothing charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing. Fixed price per run, not per answer. Charged in full when at least 3 of 4 platforms are measured (a platform counts when at least 2 of its 3 askings answer with sources); otherwise it refuses and nothing is charged. So a charged run can rest on fewer than all 16 answers; the result reports exactly how many, per platform.",
        "x-payment-info": {
          "amount": "180",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH AI-visibility run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "question",
                  "domain"
                ],
                "properties": {
                  "question": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 100
                  },
                  "domain": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "question": "What is the best project management software for small agencies?",
                "domain": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: per platform, the everyday askings (cited in, positions, verdict) and the flagship asking (cited, agrees); citation rate; stability; model tier; most cited other domains; the controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The AI answer API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one moment; re-run to build a series",
          "compare": null,
          "place": null,
          "segment": "question (one buyer question per run)"
        }
      }
    },
    "/run/ai-visibility-quick": {
      "post": {
        "operationId": "runAiVisibilityQuick",
        "summary": "Do AI assistants cite us? Quick: one question, four platforms, asked twice each (8 answers), under $1",
        "description": "Asks ChatGPT, Claude, Gemini and Perplexity one buyer question live with web search on, twice each on the everyday model, and returns per platform whether the domain was cited, at what positions and whether that held both times, plus the domains cited most instead. No flagship comparison (see /run/ai-visibility). Fewer than 3 platforms answering with sources: 422, nothing charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing. Fixed price per run, not per answer. Charged in full when at least 3 of 4 platforms are measured (a platform counts when both of its 2 askings answer with sources); otherwise it refuses and nothing is charged. So a charged run can rest on fewer than all 8 answers; the result reports exactly how many, per platform.",
        "x-payment-info": {
          "amount": "106",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH ai-visibility-quick run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "question",
                  "domain"
                ],
                "properties": {
                  "question": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 100
                  },
                  "domain": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "question": "What is the best project management software for small agencies?",
                "domain": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: per platform, the everyday askings (cited in, positions, verdict) and the flagship asking (cited, agrees); citation rate; stability; model tier; most cited other domains; the controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The AI answer API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one moment; re-run to build a series",
          "compare": null,
          "place": null,
          "segment": "question"
        }
      }
    },
    "/run/disclosure-check": {
      "post": {
        "operationId": "runDisclosureCheck",
        "summary": "Has anyone started reporting this number? Which filers use a phrase in their SEC filings, with the filings linked",
        "description": "Searches SEC EDGAR full text for the phrase in 10-K, 10-Q or 8-K filings over the years given, across all filers or 2-10 named peers. For peers: who uses it, who does not, and who could not be measured because they filed nothing (positive control). A null phrase must return 0. Using a phrase is not the same as disclosing the figure: the filings are linked to read. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH disclosure-check run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phrase"
                ],
                "properties": {
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80,
                    "description": "The phrase to search for, without quote marks."
                  },
                  "peers": {
                    "type": "string",
                    "description": "Optional: 2-10 tickers, comma-separated"
                  },
                  "form": {
                    "type": "string",
                    "enum": [
                      "10-K",
                      "10-Q",
                      "8-K"
                    ]
                  },
                  "start": {
                    "type": "integer",
                    "minimum": 2001
                  },
                  "end": {
                    "type": "integer"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "phrase": "vitality index",
                "peers": "GIS,CAG,CPB,KHC",
                "start": 2024,
                "end": 2026
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: by-year counts, denominator and share; both controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "SEC EDGAR could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: filers by year (start-end)",
          "compare": "peers",
          "place": null,
          "segment": "form (10-K, 10-Q, 8-K)"
        }
      }
    },
    "/run/regulatory-clock": {
      "post": {
        "operationId": "runRegulatoryClock",
        "summary": "Is there still time to respond? U.S. federal documents on a topic open for comment, and final rules waiting to take effect",
        "description": "As of today, Federal Register documents mentioning the phrase whose comment period is still open (with days left), and final rules whose effective date is still ahead, optionally for one agency. A null phrase must return 0, and every returned date must fall on or after today, or the run refuses. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH regulatory-clock run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phrase"
                ],
                "properties": {
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80,
                    "description": "The phrase to search for, without quote marks."
                  },
                  "agency": {
                    "type": "string",
                    "enum": [
                      "fda",
                      "usda",
                      "ftc",
                      "epa",
                      "cpsc",
                      "fcc",
                      "sec",
                      "dol",
                      "treasury"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "phrase": "front-of-package",
                "agency": "fda"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: by-year counts, denominator and share; both controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The Federal Register API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "as of today: open comment periods and dates ahead",
          "compare": null,
          "place": null,
          "segment": "agency"
        }
      }
    },
    "/run/deal-activity": {
      "post": {
        "operationId": "runDealActivity",
        "summary": "Is M&A in this sector rising or falling, and who is doing it? 8-K merger agreements mentioning a sector, as a share of all of them, by quarter",
        "description": "For the last 4-12 complete quarters, SEC EDGAR full-text search counts of 8-K documents containing \"agreement and plan of merger\" and the sector phrase, against all 8-K merger-agreement documents; the direction of the share; an industry-code (SIC) cross-check; and the most active filers, linked. A null phrase must return 0 (which also proves both phrases are required), every quarter's denominator must be above 0 and below 10,000, and no sector count may exceed it, or the run refuses. It counts documents, not deals. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH deal-activity run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "sector": {
                    "type": "string",
                    "enum": [
                      "cybersecurity",
                      "games",
                      "streaming",
                      "film-studios",
                      "cpg",
                      "erp",
                      "saas"
                    ]
                  },
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80,
                    "description": "Your own sector phrase, without quote marks. Not with sector."
                  },
                  "sic": {
                    "type": "string",
                    "description": "Optional, with phrase: four-digit SIC codes, comma-separated."
                  },
                  "quarters": {
                    "type": "integer",
                    "minimum": 4,
                    "maximum": 12
                  }
                }
              },
              "example": {
                "sector": "cybersecurity",
                "quarters": 8
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: by-quarter counts, denominator and share; direction by phrase and by industry code; most active filers; the controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (sector, phrase, sic or quarters)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "SEC EDGAR full-text search could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: share by quarter (quarters)",
          "compare": null,
          "place": null,
          "segment": "sector, phrase or SIC code"
        }
      }
    },
    "/run/demand-check": {
      "post": {
        "operationId": "runDemandCheck",
        "summary": "Is demand for this real, or is search moving for everyone? Search demand against an everyday control basket, confirmed against SEC filings",
        "description": "Year-on-year Google search change for a category (DataForSEO Labs) against a fixed basket of ten everyday searches, the excess beyond the market, a volume band, and a cross-check against the share of 10-K filers mentioning the phrase (SEC EDGAR). The basket must itself move less than 20% or the run refuses. Changes and bands only, never monthly volumes. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH demand-check run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "phrase"
                ],
                "properties": {
                  "phrase": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 60
                  },
                  "also": {
                    "type": "string",
                    "description": "Up to 4 more keywords, comma-separated."
                  }
                }
              },
              "example": {
                "phrase": "protein snacks",
                "also": "high protein snacks,protein bars"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: category, market and excess change, direction, volume bands, the filings cross-check and its confirmation, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: latest 12 months against the 12 before",
          "compare": null,
          "place": null,
          "segment": "also (a second phrase for the category)"
        }
      }
    },
    "/run/answer-share": {
      "post": {
        "operationId": "runAnswerShare",
        "summary": "Who owns the answer in my category? Domains cited across AI answers to 2-3 buyer questions, each asked twice",
        "description": "Asks ChatGPT, Claude, Gemini and Perplexity 2-3 buyer questions live with web search on, each twice, and returns the ten most-cited domains as counts of answers, the category shape (owned, led, contested, fragmented), stability between askings, and optionally where your domain stands. Domain-level counts only, never the answers. Fewer than half the answers, or under 3 platforms, citing sources: 422, nothing charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing. Fixed price per run, not per answer. Charged in full when at least half the answers cite sources and at least 3 of 4 platforms do; otherwise it refuses and nothing is charged. So a charged run can rest on as few as 12 of 24 answers (fewer with two questions); the result reports exactly how many (controls.measurement).",
        "x-payment-info": {
          "amount": "254",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH answer-share run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "q1",
                  "q2"
                ],
                "properties": {
                  "q1": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 100
                  },
                  "q2": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 100
                  },
                  "q3": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 100
                  },
                  "domain": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "q1": "What is the best CRM for a small agency?",
                "q2": "Which CRM do marketing agencies use?",
                "domain": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: most-cited domains with counts, category shape, stability, by-question leaders, your domain if given, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one moment; re-run to build a series",
          "compare": null,
          "place": null,
          "segment": "q1-q3 (buyer questions)"
        }
      }
    },
    "/run/answer-share-quick": {
      "post": {
        "operationId": "runAnswerShareQuick",
        "summary": "Who owns the answer in my category? Quick: two buyer questions, four platforms, asked once each (8 answers), under $1",
        "description": "Asks ChatGPT, Claude, Gemini and Perplexity two buyer questions live with web search on, once each, and returns the ten most-cited domains as counts of answers, the category shape (owned, led, contested, fragmented), and optionally where your domain stands. No stability check (see /run/answer-share). Domain-level counts only, never the answers. Fewer than half the answers, or under 3 platforms, citing sources: 422, nothing charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing. Fixed price per run, not per answer. Charged in full when at least half the answers cite sources and at least 3 of 4 platforms do; otherwise it refuses and nothing is charged. So a charged run can rest on as few as 4 of 8 answers; the result reports exactly how many (controls.measurement).",
        "x-payment-info": {
          "amount": "106",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH answer-share-quick run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "q1",
                  "q2"
                ],
                "properties": {
                  "q1": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 100
                  },
                  "q2": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 100
                  },
                  "domain": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "q1": "What is the best CRM for a small agency?",
                "q2": "Which CRM do marketing agencies use?",
                "domain": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: most-cited domains with counts, category shape, by-question leaders, your domain if given, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one moment; re-run to build a series",
          "compare": null,
          "place": null,
          "segment": "q1-q2"
        }
      }
    },
    "/run/share-of-search": {
      "post": {
        "operationId": "runShareOfSearch",
        "summary": "Who is gaining share of search in this category? Brand share of US Google searches among named rivals",
        "description": "Each brand's share of US Google searches among the brands named (DataForSEO Labs), latest 12 months against the 12 before, the change in points, search growth and a volume band. The brand and at least 2 rivals need 24 clean months or the run refuses. Shares and bands only. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH share-of-search run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "brand",
                  "rivals"
                ],
                "properties": {
                  "brand": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 40
                  },
                  "rivals": {
                    "type": "string",
                    "description": "2-6 brands, comma-separated."
                  }
                }
              },
              "example": {
                "brand": "Quest Nutrition",
                "rivals": "RXBAR,Clif Bar,KIND Snacks"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: latest 12 months against the 12 before",
          "compare": "rivals",
          "place": null,
          "segment": null
        }
      }
    },
    "/run/premium-check": {
      "post": {
        "operationId": "runPremiumCheck",
        "summary": "Is our premium holding? Price-seeking searches as a share of brand searches",
        "description": "Searches for the brand with price, cheap, discount, coupon, dupe, alternative or sale, as a share of searches for the brand alone (DataForSEO Labs), latest 12 months against the 12 before, with a verdict. A null modifier must read zero and the brand must average 1,000 searches a month, or the run refuses. Shares and bands only. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH premium-check run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "brand"
                ],
                "properties": {
                  "brand": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 40
                  }
                }
              },
              "example": {
                "brand": "Yeti"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: latest 12 months against the 12 before",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/angle-demand": {
      "post": {
        "operationId": "runAngleDemand",
        "summary": "Which reason to buy do people search for, and which is growing? Buying angles in a category against an everyday control basket",
        "description": "US Google searches for each angle with the category (\"healthy protein snacks\"), share among the angles named, year-on-year change and growth beyond an everyday basket of ten searches (DataForSEO Labs). The basket must move less than 20% and at least 2 angles need 24 clean months, or the run refuses. Shares and bands only. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH angle-demand run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "category",
                  "angles"
                ],
                "properties": {
                  "category": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 40
                  },
                  "angles": {
                    "type": "string",
                    "description": "2-6 reasons to buy, comma-separated."
                  }
                }
              },
              "example": {
                "category": "protein snacks",
                "angles": "healthy,vegan,keto,cheap"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: share and growth over 12 months",
          "compare": null,
          "place": null,
          "segment": "angles (each buying reason)"
        }
      }
    },
    "/run/channel-mix": {
      "post": {
        "operationId": "runChannelMix",
        "summary": "Where do buyers find options when they search? The US Google top 10 classed by channel",
        "description": "The organic Google top 10 for 1-3 buyer searches (DataForSEO SERP), United States, each result classed by domain: retailers and marketplaces, reviews and media, brand sites, forums and social, reference, independent and specialist sites. A control search with a known answer must come back retailer-led, or the run refuses. Domains, ranks and counts only. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH channel-mix run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "q1"
                ],
                "properties": {
                  "q1": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "q2": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "q3": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "brand_domains": {
                    "type": "string",
                    "description": "Up to 10 domains, comma-separated."
                  },
                  "retailer_domains": {
                    "type": "string",
                    "description": "Up to 10 domains, comma-separated."
                  },
                  "media_domains": {
                    "type": "string",
                    "description": "Up to 10 domains, comma-separated."
                  }
                }
              },
              "example": {
                "q1": "best protein bars",
                "q2": "healthy protein snacks",
                "brand_domains": "rxbar.com,questnutrition.com,clifbar.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one moment",
          "compare": "brand_domains, retailer_domains, media_domains",
          "place": null,
          "segment": "q1-q3 (buyer searches)"
        }
      }
    },
    "/run/claim-check": {
      "post": {
        "operationId": "runClaimCheck",
        "summary": "Is this claim already taken by a competitor? Home pages now against a year ago",
        "description": "Whether 3-5 competitors' home pages lead with a claim, mention it or not, read live (robots.txt obeyed) and from the Internet Archive copy nearest a year earlier. A null claim must match no site and at least 3 pages must be readable, or the run refuses. No page text is returned. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH claim-check run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "claim",
                  "sites"
                ],
                "properties": {
                  "claim": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 60
                  },
                  "variants": {
                    "type": "string",
                    "description": "Up to 3 other wordings, comma-separated."
                  },
                  "sites": {
                    "type": "string",
                    "description": "3-5 competitor domains, comma-separated."
                  }
                }
              },
              "example": {
                "claim": "plant-based protein",
                "variants": "plant protein",
                "sites": "rxbar.com,questnutrition.com,clifbar.com,kindsnacks.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: today against a year ago",
          "compare": "sites (3-5 competitors)",
          "place": null,
          "segment": "variants (wordings of the claim)"
        }
      }
    },
    "/run/fad-check": {
      "post": {
        "operationId": "runFadCheck",
        "summary": "Is this moment lasting, or past its peak? Search and Wikipedia retention against controls",
        "description": "How much of its best 12 months a subject keeps on US Google Trends (DataForSEO) and English Wikipedia (Wikimedia, against four fixed articles), since January 2016. A control term must hold steady, both signals must be measurable, and not both still at their peak, or the run refuses. Ratios and dates only. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH fad-check run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "term",
                  "article"
                ],
                "properties": {
                  "term": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 60
                  },
                  "article": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 100
                  }
                }
              },
              "example": {
                "term": "cottage cheese",
                "article": "Cottage cheese"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: monthly since January 2016",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/revenue-mix": {
      "post": {
        "operationId": "runRevenueMix",
        "summary": "Where does this company's revenue come from, and how is the mix moving? Revenue splits from 10-K XBRL",
        "description": "Every revenue split one company files (platform, revenue type, channel, product, region) whose parts add to reported revenue within 1% in the newest year and in 3+ years, with every part in each of its three latest 10-Ks, read from the XBRL instances as filed (SEC EDGAR). Each fiscal year's shares and values, and each filing's citation. Identity is checked twice (submissions name and the instance's own CIK). If the company files no split the run can verify, it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH revenue-mix run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "ticker"
                ],
                "properties": {
                  "ticker": {
                    "type": "string",
                    "enum": [
                      "PEP",
                      "KO",
                      "K",
                      "POST",
                      "KDP",
                      "CELH",
                      "UTZ",
                      "HRL",
                      "GIS",
                      "KHC",
                      "CAG",
                      "CPB",
                      "HSY",
                      "MDLZ",
                      "SJM",
                      "CLX",
                      "CL",
                      "CHD",
                      "PG",
                      "SMPL",
                      "BRBR",
                      "MSFT",
                      "EA",
                      "TTWO",
                      "RBLX",
                      "OMC",
                      "STGW",
                      "CRM",
                      "HUBS",
                      "TDOC",
                      "TALK",
                      "GDDY",
                      "GEN",
                      "NFLX",
                      "AMZN"
                    ]
                  }
                }
              },
              "example": {
                "ticker": "TTWO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: three latest 10-Ks",
          "compare": null,
          "place": null,
          "segment": "every split the company files (product, channel, region)"
        }
      }
    },
    "/run/launch-lift": {
      "post": {
        "operationId": "runLaunchLift",
        "summary": "Has this launch lifted the brand it came from? Whether a launch or premiere month lifted the parent brand or show's US search past +20%, against a seasonal control a year earlier. Ratios only.",
        "description": "Whether a launch or premiere month lifted the parent brand or show's US search past +20%, against a seasonal control a year earlier. Ratios only. Lift is the launch month against the mean of the three months before it. The bar, +20%, is fixed before the pull, so a smaller rise is reported as no lift, however it looks on a chart. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH launch-lift run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "parent",
                  "launch"
                ],
                "properties": {
                  "parent": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 60
                  },
                  "launch": {
                    "type": "string",
                    "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
                  },
                  "article": {
                    "type": "string",
                    "maxLength": 100
                  }
                }
              },
              "example": {
                "parent": "power",
                "launch": "2025-11",
                "article": "Power (TV series)"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: the launch month against the same window in other years",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/comment-themes": {
      "post": {
        "operationId": "runCommentThemes",
        "summary": "What are people saying under this video? What share of the top comments under up to five YouTube videos mention each of up to eight themes named in advance. Counts and shares only.",
        "description": "What share of the top comments under up to five YouTube videos mention each of up to eight themes named in advance. Counts and shares only. Comments are YouTube's top-level comments in its own relevance order, up to 200 per video: a sample of the most visible comments, not every comment. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH comment-themes run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "videos",
                  "themes"
                ],
                "properties": {
                  "videos": {
                    "type": "string"
                  },
                  "themes": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "videos": "dQw4w9WgXcQ",
                "themes": "disc,price,story"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one moment",
          "compare": "videos (up to five)",
          "place": null,
          "segment": "themes"
        }
      }
    },
    "/run/customer-concentration": {
      "post": {
        "operationId": "runCustomerConcentration",
        "summary": "Is this company dependent on one big customer? The share of revenue from a public company's largest customer, as tagged in its three latest 10-Ks.",
        "description": "The share of revenue from a public company's largest customer, as tagged in its three latest 10-Ks. Read from the ConcentrationRiskPercentage1 facts that a company tags against revenue and customer concentration in its three latest 10-Ks. A company must name a customer at or above 10% of revenue (ASC 280), so a figure below 10% is usually a voluntary disclosure. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH customer-concentration run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "ticker"
                ],
                "properties": {
                  "ticker": {
                    "type": "string",
                    "enum": [
                      "PEP",
                      "KO",
                      "K",
                      "POST",
                      "KDP",
                      "CELH",
                      "UTZ",
                      "HRL",
                      "GIS",
                      "KHC",
                      "CAG",
                      "CPB",
                      "HSY",
                      "MDLZ",
                      "SJM",
                      "CLX",
                      "CL",
                      "CHD",
                      "PG",
                      "SMPL",
                      "BRBR",
                      "MSFT",
                      "EA",
                      "TTWO",
                      "RBLX",
                      "OMC",
                      "STGW",
                      "CRM",
                      "HUBS",
                      "TDOC",
                      "TALK",
                      "GDDY",
                      "GEN",
                      "NFLX",
                      "AMZN"
                    ]
                  }
                }
              },
              "example": {
                "ticker": "GIS"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: three latest 10-Ks",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/write-downs": {
      "post": {
        "operationId": "runWriteDowns",
        "summary": "Has this company written down what it bought? Every goodwill and intangible impairment a public company has tagged in its 10-K XBRL, by fiscal year.",
        "description": "Every goodwill and intangible impairment a public company has tagged in its 10-K XBRL, by fiscal year. Impairments as tagged in 10-K XBRL: goodwill, indefinite-lived intangibles (mostly brands and trademarks), finite-lived intangibles, and the combined line some companies use instead. Lines are not added where a company files both a combined and a split figure. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH write-downs run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "ticker"
                ],
                "properties": {
                  "ticker": {
                    "type": "string",
                    "enum": [
                      "PEP",
                      "KO",
                      "K",
                      "POST",
                      "KDP",
                      "CELH",
                      "UTZ",
                      "HRL",
                      "GIS",
                      "KHC",
                      "CAG",
                      "CPB",
                      "HSY",
                      "MDLZ",
                      "SJM",
                      "CLX",
                      "CL",
                      "CHD",
                      "PG",
                      "SMPL",
                      "BRBR",
                      "MSFT",
                      "EA",
                      "TTWO",
                      "RBLX",
                      "OMC",
                      "STGW",
                      "CRM",
                      "HUBS",
                      "TDOC",
                      "TALK",
                      "GDDY",
                      "GEN",
                      "NFLX",
                      "AMZN"
                    ]
                  }
                }
              },
              "example": {
                "ticker": "KHC"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: every fiscal year tagged",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/cost-squeeze": {
      "post": {
        "operationId": "runCostSqueeze",
        "summary": "Has this input cost reached the company's margin? Whether a commodity's price move since fiscal 2019 shows up in a company's filed gross margin. Consistent-with, not cause.",
        "description": "Whether a commodity's price move since fiscal 2019 shows up in a company's filed gross margin. Consistent-with, not cause. Gross margin is (revenue minus cost of sales) over revenue, as each company tags it in its 10-K; the commodity price is the IMF global monthly price via FRED, averaged over the same fiscal year. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH cost-squeeze run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "ticker",
                  "commodity"
                ],
                "properties": {
                  "ticker": {
                    "type": "string",
                    "enum": [
                      "PEP",
                      "KO",
                      "K",
                      "POST",
                      "KDP",
                      "CELH",
                      "UTZ",
                      "HRL",
                      "GIS",
                      "KHC",
                      "CAG",
                      "CPB",
                      "HSY",
                      "MDLZ",
                      "SJM",
                      "CLX",
                      "CL",
                      "CHD",
                      "PG",
                      "SMPL",
                      "BRBR",
                      "MSFT",
                      "EA",
                      "TTWO",
                      "RBLX",
                      "OMC",
                      "STGW",
                      "CRM",
                      "HUBS",
                      "TDOC",
                      "TALK",
                      "GDDY",
                      "GEN",
                      "NFLX",
                      "AMZN"
                    ]
                  },
                  "commodity": {
                    "type": "string",
                    "enum": [
                      "cocoa",
                      "coffee",
                      "sugar",
                      "wheat",
                      "corn",
                      "beef",
                      "aluminum",
                      "crude_oil"
                    ]
                  }
                }
              },
              "example": {
                "ticker": "HSY",
                "commodity": "cocoa"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: fiscal years since 2019",
          "compare": null,
          "place": null,
          "segment": "commodity"
        }
      }
    },
    "/run/trade-concentration": {
      "post": {
        "operationId": "runTradeConcentration",
        "summary": "Where do US imports of this product come from now? How concentrated US imports of one HS code are across partner countries in two years, and who gained or lost share.",
        "description": "How concentrated US imports of one HS code are across partner countries in two years, and who gained or lost share. US general imports as the US Census Bureau reports them (customs value, USD), full calendar year, for one HS code, across every partner country. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH trade-concentration run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "hs",
                  "start",
                  "end"
                ],
                "properties": {
                  "hs": {
                    "type": "string",
                    "pattern": "^\\d{4}(\\d{2})?$"
                  },
                  "start": {
                    "type": "integer",
                    "minimum": 2010
                  },
                  "end": {
                    "type": "integer"
                  }
                }
              },
              "example": {
                "hs": "8542",
                "start": 2019,
                "end": 2024
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: two years (start, end)",
          "compare": null,
          "place": "partner countries (in the result)",
          "segment": null
        }
      }
    },
    "/run/series-forecast": {
      "post": {
        "operationId": "runSeriesForecast",
        "summary": "What will this US series do over the next 12 months? A 12-month forecast of one US monthly series, issued only if it beat \"same month last year\" on the series' own last three years.",
        "description": "A 12-month forecast of one US monthly series, issued only if it beat \"same month last year\" on the series' own last three years. The model is Holt-Winters, trained on up to the last 20 years; the benchmark is seasonal-naive. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH series-forecast run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "series"
                ],
                "properties": {
                  "series": {
                    "type": "string",
                    "enum": [
                      "RSXFSN",
                      "RSAFSNA",
                      "MRTSSM44000USN",
                      "MRTSSM4451USN",
                      "MRTSSM4453USN",
                      "MRTSSM448USN",
                      "UNRATENSA",
                      "PAYNSA",
                      "CEU0500000003",
                      "CEU7000000001",
                      "CEU4200000001",
                      "CPIAUCNS",
                      "CUUR0000SAF11",
                      "CUUR0000SAE1",
                      "CUUR0000SAH21",
                      "CUUR0000SEHA",
                      "IPG2211A2N",
                      "IPN31152N",
                      "HOUSTNSA",
                      "HSN1FNSA",
                      "TTLCON",
                      "TOTALNSA"
                    ]
                  }
                }
              },
              "example": {
                "series": "RSXFSN"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: 12-month forecast with three years of backtest",
          "compare": null,
          "place": null,
          "segment": "series"
        }
      }
    },
    "/run/threshold-odds": {
      "post": {
        "operationId": "runThresholdOdds",
        "summary": "What are the odds this US series crosses a line in the next three months? The probability that a US series' year-on-year change is above or below a line in a month up to three months past its latest figure.",
        "description": "The probability that a US series' year-on-year change is above or below a line in a month up to three months past its latest figure, from the model's own last 36 forecast errors. Tested at 3 months on these series (Nov 13, 2026): it beat both a same-month-last-year probability and the base rate. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH threshold-odds run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "series",
                  "month",
                  "yoy_pct"
                ],
                "properties": {
                  "series": {
                    "type": "string",
                    "enum": [
                      "CUUR0000SEHA",
                      "CUUR0000SAF11",
                      "CUUR0000SAH21",
                      "CEU0500000003",
                      "CUUR0000SAE1",
                      "RSXFSN",
                      "MRTSSM44000USN",
                      "MRTSSM4451USN",
                      "IPG2211A2N"
                    ]
                  },
                  "month": {
                    "type": "string",
                    "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
                  },
                  "yoy_pct": {
                    "type": "number",
                    "minimum": -50,
                    "maximum": 100
                  },
                  "direction": {
                    "type": "string",
                    "enum": [
                      "above",
                      "below"
                    ]
                  }
                }
              },
              "example": {
                "series": "CUUR0000SEHA",
                "month": "2026-12",
                "yoy_pct": 3,
                "direction": "above"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one month up to three ahead (month)",
          "compare": null,
          "place": null,
          "segment": "series, line (yoy_pct) and direction"
        }
      }
    },
    "/run/effective-duty": {
      "post": {
        "operationId": "runEffectiveDuty",
        "summary": "What duty did importers actually pay on this product? The duty US importers actually paid on one HS code, as a share of value, for all countries and the five largest sources and any named countries, in two months between January 2025 and July 2026, and how it moved.",
        "description": "The duty US importers actually paid on one HS code, as a share of value, for all countries and the five largest sources and any named countries, in two months between January 2025 and July 2026, and how it moved. Duty as Census calculates it at entry (imports for consumption), divided by customs value. An estimate, not cash collected: it ran about 10% below Treasury's gross customs receipts. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH effective-duty run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "hs",
                  "from",
                  "to"
                ],
                "properties": {
                  "hs": {
                    "type": "string",
                    "pattern": "^\\d{4}(\\d{2}(\\d{4})?)?$"
                  },
                  "from": {
                    "type": "string",
                    "pattern": "^(2025-(0[1-9]|1[0-2])|2026-0[1-7])$"
                  },
                  "to": {
                    "type": "string",
                    "pattern": "^(2025-(0[1-9]|1[0-2])|2026-0[1-7])$"
                  },
                  "countries": {
                    "type": "string",
                    "maxLength": 210
                  }
                }
              },
              "example": {
                "hs": "8542",
                "from": "2025-01",
                "to": "2025-10"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the figures, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A source could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: two months (from, to)",
          "compare": "countries",
          "place": "countries",
          "segment": null
        }
      }
    },
    "/run/tariff-clock": {
      "post": {
        "operationId": "runTariffClock",
        "summary": "Which tariff actions touch this product, and what dates are coming? Federal Register documents from USTR, Commerce (ITA and BIS), CBP and the President that mention a product, an HTS heading, a country or a tariff action.",
        "description": "Federal Register documents from USTR, Commerce (ITA and BIS), CBP and the President that mention a product, an HTS heading, a country or a tariff action: recent actions, open comment periods and effective dates ahead. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH tariff-clock run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "phrase"
                ],
                "properties": {
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "agency": {
                    "type": "string",
                    "enum": [
                      "ustr",
                      "ita",
                      "bis",
                      "cbp",
                      "president"
                    ]
                  },
                  "since_days": {
                    "type": "integer",
                    "minimum": 30,
                    "maximum": 365
                  }
                }
              },
              "example": {
                "phrase": "forced labor",
                "agency": "ustr",
                "since_days": 180
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: by-year counts, denominator and share; both controls; limits; run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (phrase or years)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The Federal Register API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: recent actions over since_days, and dates ahead",
          "compare": null,
          "place": null,
          "segment": "agency"
        }
      }
    },
    "/run/city-profile": {
      "post": {
        "operationId": "runCityProfile",
        "summary": "Is this city's housing supply keeping up with its rent and population? One US city of 65,000+ residents, from US Census Bureau data.",
        "description": "One US city of 65,000+ residents: population, households, median rent, income, rent burden and work from home in 2019 and 2023-2025 against the US, and housing units permitted each year 2015-2025, with a check that the permit file is believable for the city. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH city-profile run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "state",
                  "place"
                ],
                "properties": {
                  "state": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{2}$"
                  },
                  "place": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 60
                  }
                }
              },
              "example": {
                "state": "MN",
                "place": "St. Paul"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the city's ACS figures beside the US, permits by year and per 1,000 residents, the controls, limits, run_id, ran_at and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run (state or place)."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The Census Bureau could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: 2019 against 2023-2025, permits 2015-2025",
          "compare": null,
          "place": "state and place",
          "segment": null
        }
      }
    },
    "/run/deal-comps": {
      "post": {
        "operationId": "runDealComps",
        "summary": "What multiples did bankers use for comparable deals in this sector? The enterprise-value multiple ranges that targets’ financial advisors applied in precedent-transactions analyses, as written in recent merger proxies and S-4s for a sector. As written, never averaged.",
        "description": "The enterprise-value multiple ranges that targets’ financial advisors applied in precedent-transactions analyses, as written in recent merger proxies and S-4s for a sector. As written, never averaged. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH deal-comps run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sector": {
                    "type": "string",
                    "enum": [
                      "cybersecurity",
                      "games",
                      "streaming",
                      "film-studios",
                      "cpg",
                      "erp",
                      "saas"
                    ]
                  },
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "years": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 5
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "sector": "cpg",
                "years": 3
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the five most recent read in full, every multiple range their advisors applied with the sentence and a link, a summary by metric; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "SEC EDGAR could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: proxies over the last years",
          "compare": null,
          "place": null,
          "segment": "sector or phrase"
        }
      }
    },
    "/run/concentration-benchmark": {
      "post": {
        "operationId": "runConcentrationBenchmark",
        "summary": "Is this dependence on one customer high or normal for its peers? The largest customer’s share of revenue across 2-6 public peers, from their latest 10-Ks, with the median and range, and where a target sits against them: a public company, or a private target’s own figure.",
        "description": "The largest customer’s share of revenue across 2-6 public peers, from their latest 10-Ks, with the median and range, and where a target sits against them: a public company, or a private target’s own figure. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH concentration-benchmark run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "peers": {
                    "type": "string"
                  },
                  "ticker": {
                    "type": "string"
                  },
                  "target_share": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 100
                  }
                },
                "required": [
                  "peers"
                ],
                "additionalProperties": false
              },
              "example": {
                "peers": "GIS,CAG,CPB,SJM,HSY",
                "target_share": 30
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: each one’s largest-customer share of revenue from its latest 10-K, the median and range, and where the target sits; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "SEC EDGAR could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one release (latest 10-Ks)",
          "compare": "peers",
          "place": null,
          "segment": null
        }
      }
    },
    "/run/demand-durability": {
      "post": {
        "operationId": "runDemandDurability",
        "summary": "Is demand for this brand durable? Share of search against named rivals and fad-check on the brand itself, read together: is the brand holding share, and is interest lasting? A combined label only when the two agree.",
        "description": "Share of search against named rivals and fad-check on the brand itself, read together: is the brand holding share, and is interest lasting? A combined label only when the two agree. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH demand-durability run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "brand": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 40
                  },
                  "rivals": {
                    "type": "string"
                  },
                  "article": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 100
                  }
                },
                "required": [
                  "brand",
                  "rivals",
                  "article"
                ],
                "additionalProperties": false
              },
              "example": {
                "brand": "celsius",
                "rivals": "monster energy,red bull,ghost energy",
                "article": "Celsius Holdings"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: share of search and its change, interest lasting or fading on search and Wikipedia, and a combined label; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "DataForSEO or Wikimedia could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: 12 months against the 12 before, and since 2016",
          "compare": "rivals",
          "place": null,
          "segment": null
        }
      }
    },
    "/run/merger-review": {
      "post": {
        "operationId": "runMergerReview",
        "summary": "Do antitrust agencies require remedies for mergers in this sector, and how often? FTC consent orders and Justice Department consent decrees for mergers that mention a sector or product, by year, each linked: how often the agencies have required remedies in this space.",
        "description": "FTC consent orders and Justice Department consent decrees for mergers that mention a sector or product, by year, each linked: how often the agencies have required remedies in this space. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH merger-review run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "since_year": {
                    "type": "integer",
                    "minimum": 2000
                  }
                },
                "required": [
                  "phrase"
                ],
                "additionalProperties": false
              },
              "example": {
                "phrase": "hospital",
                "since_year": 2018
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: FTC and Justice Department merger settlements, counted by year, each with its title, date, document number and link; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The Federal Register API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: by year since since_year",
          "compare": null,
          "place": null,
          "segment": "phrase (sector or product)"
        }
      }
    },
    "/run/private-raises": {
      "post": {
        "operationId": "runPrivateRaises",
        "summary": "Is private money flowing into this industry or away from it? Form D notices of private offerings naming an industry group, as a share of all Form D notices, quarter by quarter, with the latest issuers and the amounts they stated.",
        "description": "Form D notices of private offerings naming an industry group, as a share of all Form D notices, quarter by quarter, with the latest issuers and the amounts they stated. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH private-raises run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "industry": {
                    "type": "string",
                    "enum": [
                      "agriculture",
                      "biotechnology",
                      "pharmaceuticals",
                      "hospitals-and-physicians",
                      "health-insurance",
                      "other-health-care",
                      "pooled-investment-fund",
                      "commercial-banking",
                      "investment-banking",
                      "oil-and-gas",
                      "electric-utilities",
                      "energy-conservation",
                      "environmental-services",
                      "coal-mining",
                      "computers",
                      "telecommunications",
                      "other-technology",
                      "reits-and-finance",
                      "other-real-estate",
                      "retailing",
                      "restaurants",
                      "business-services",
                      "lodging-and-conventions",
                      "airlines-and-airports",
                      "tourism-and-travel-services"
                    ]
                  },
                  "quarters": {
                    "type": "integer",
                    "minimum": 4,
                    "maximum": 12
                  }
                },
                "required": [
                  "industry"
                ],
                "additionalProperties": false
              },
              "example": {
                "industry": "biotechnology",
                "quarters": 8
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: Form D notices as a share of all, the direction, and the latest issuers with stated amounts and links; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "SEC EDGAR could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: share by quarter (quarters)",
          "compare": null,
          "place": null,
          "segment": "industry"
        }
      }
    },
    "/run/contractor-revenue": {
      "post": {
        "operationId": "runContractorRevenue",
        "summary": "What federal contract money does this company win, and from which agencies? One company’s federal prime contract obligations by fiscal year and by awarding agency, with agency concentration (HHI) and the recipient names matched.",
        "description": "One company’s federal prime contract obligations by fiscal year and by awarding agency, with agency concentration (HHI) and the recipient names matched. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH contractor-revenue run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "recipient": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "years": {
                    "type": "integer",
                    "minimum": 3,
                    "maximum": 8
                  }
                },
                "required": [
                  "recipient"
                ],
                "additionalProperties": false
              },
              "example": {
                "recipient": "Booz Allen Hamilton",
                "years": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: contract obligations by year, top agencies and shares, agency HHI and the names matched; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "USAspending.gov could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: by fiscal year (years)",
          "compare": null,
          "place": null,
          "segment": "awarding agency (in the result)"
        }
      }
    },
    "/run/ai-readiness": {
      "post": {
        "operationId": "runAiReadiness",
        "summary": "Is this site readable by AI assistants? Whether AI search crawlers, live fetchers and training crawlers may read a site, whether it has an llms.txt, and whether its home page reads without JavaScript, with structured data and a page subject. A checklist with a fix for each failure; no composite score.",
        "description": "Whether AI search crawlers, live fetchers and training crawlers may read a site, whether it has an llms.txt, and whether its home page reads without JavaScript, with structured data and a page subject. A checklist with a fix for each failure; no composite score. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH ai-readiness run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "minLength": 4,
                    "maxLength": 100
                  }
                },
                "required": [
                  "domain"
                ],
                "additionalProperties": false
              },
              "example": {
                "domain": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: a checklist (AI search crawlers, live fetchers, llms.txt, page readable without script, H1, structured data, meta description, noindex) with a fix for each failure, every AI crawler token’s verdict, the controls, the limits, a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The site could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one moment; re-run after a fix",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/search-vs-ai": {
      "post": {
        "operationId": "runSearchVsAi",
        "summary": "Do this question’s Google winners also win the AI answer? For one buyer question: Google’s top 10 organic domains against the domains four AI assistants cite in eight answers. How many Google winners the AI also cites, which sources only the AI cites, and where your domain stands in each.",
        "description": "For one buyer question: Google’s top 10 organic domains against the domains four AI assistants cite in eight answers. How many Google winners the AI also cites, which sources only the AI cites, and where your domain stands in each. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "106",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH search-vs-ai run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "question": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 200
                  },
                  "domain": {
                    "type": "string",
                    "maxLength": 100
                  }
                },
                "required": [
                  "question"
                ],
                "additionalProperties": false
              },
              "example": {
                "question": "best project management software for small teams",
                "domain": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: Google’s top 10 with each domain’s AI citation count, the overlap, the AI-only sources, and where example.com stands; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "DataForSEO could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one moment; re-run to build a series",
          "compare": null,
          "place": null,
          "segment": "question"
        }
      }
    },
    "/run/ai-brand-check": {
      "post": {
        "operationId": "runAiBrandCheck",
        "summary": "Do AI assistants describe us correctly? Whether four AI assistants recognize a brand and state the facts you give (founding year, headquarters, price, products), counted across eight answers, with a short excerpt where each fact appears. A check of your values against an invented brand rules out values too generic to test.",
        "description": "Whether four AI assistants recognize a brand and state the facts you give (founding year, headquarters, price, products), counted across eight answers, with a short excerpt where each fact appears. A check of your values against an invented brand rules out values too generic to test. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "115",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH ai-brand-check run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "brand": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 60
                  },
                  "facts": {
                    "type": "object",
                    "minProperties": 1,
                    "maxProperties": 5,
                    "additionalProperties": {
                      "type": "string",
                      "minLength": 2,
                      "maxLength": 60
                    }
                  }
                },
                "required": [
                  "brand",
                  "facts"
                ],
                "additionalProperties": false
              },
              "example": {
                "brand": "Trupanion",
                "facts": {
                  "headquarters": "Seattle",
                  "founded": "2000"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: recognition across eight AI answers by platform, and for each of your 2 facts how many answers state it, on which platforms, with an excerpt; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "DataForSEO could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one moment; re-run to build a series",
          "compare": null,
          "place": null,
          "segment": "facts (each fact checked)"
        }
      }
    },
    "/run/trial-pipeline": {
      "post": {
        "operationId": "runTrialPipeline",
        "summary": "Is the clinical pipeline for this condition crowding? Interventional clinical trials for one condition by start year: all, industry-sponsored and Phase 3, the direction, and the leading industry sponsors with the top-5 share over the last three years.",
        "description": "Interventional clinical trials for one condition by start year: all, industry-sponsored and Phase 3, the direction, and the leading industry sponsors with the top-5 share over the last three years. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH trial-pipeline run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "condition": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "years": {
                    "type": "integer",
                    "minimum": 3,
                    "maximum": 10
                  }
                },
                "required": [
                  "condition"
                ],
                "additionalProperties": false
              },
              "example": {
                "condition": "obesity",
                "years": 6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: trial starts by year (all, industry, Phase 3), the direction, the top industry sponsors and the top-5 share; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "ClinicalTrials.gov could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: by start year (years)",
          "compare": null,
          "place": null,
          "segment": "industry, Phase 3, sponsor (in the result)"
        }
      }
    },
    "/run/device-clearances": {
      "post": {
        "operationId": "runDeviceClearances",
        "summary": "Who is getting FDA clearance in this device category? FDA 510(k) clearance decisions for one device category (an FDA product code or a device phrase) by year, the direction, and the most active applicants over the last three years.",
        "description": "FDA 510(k) clearance decisions for one device category (an FDA product code or a device phrase) by year, the direction, and the most active applicants over the last three years. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH device-clearances run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "product_code": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 3
                  },
                  "device": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "years": {
                    "type": "integer",
                    "minimum": 3,
                    "maximum": 10
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "device": "pulse oximeter",
                "years": 6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: 510(k) decisions by year, the direction and the top applicants; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "openFDA could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: by year (years)",
          "compare": null,
          "place": null,
          "segment": "product_code or device"
        }
      }
    },
    "/run/recall-watch": {
      "post": {
        "operationId": "runRecallWatch",
        "summary": "Is this product category being recalled more? FDA recalls of food, drugs or devices whose product description contains a phrase, by year, by class (I, II, III) and by recalling firm.",
        "description": "FDA recalls of food, drugs or devices whose product description contains a phrase, by year, by class (I, II, III) and by recalling firm. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH recall-watch run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "category": {
                    "type": "string",
                    "enum": [
                      "food",
                      "drug",
                      "device"
                    ]
                  },
                  "phrase": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "years": {
                    "type": "integer",
                    "minimum": 3,
                    "maximum": 10
                  }
                },
                "required": [
                  "category",
                  "phrase"
                ],
                "additionalProperties": false
              },
              "example": {
                "category": "food",
                "phrase": "peanut butter",
                "years": 6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: recalls by year, the direction, the split by class and the top firms; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "openFDA could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: by year (years)",
          "compare": null,
          "place": null,
          "segment": "category (food, drug, device), class and firm (in the result)"
        }
      }
    },
    "/run/incentive-tracts": {
      "post": {
        "operationId": "runIncentiveTracts",
        "summary": "Is this site in an Opportunity Zone or an NMTC-eligible tract? For one address or up to 10: the census tract (2010 and 2020), whether it is in a current Opportunity Zone, an OZ 2.0 tract (effective January 1, 2027), and a tract eligible for the New Markets Tax Credit.",
        "description": "For one address or up to 10: the census tract (2010 and 2020), whether it is in a current Opportunity Zone, an OZ 2.0 tract (effective January 1, 2027), and a tract eligible for the New Markets Tax Credit. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH incentive-tracts run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 120
                  },
                  "addresses": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 10,
                    "items": {
                      "type": "string",
                      "minLength": 8,
                      "maxLength": 120
                    }
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "address": "901 Bagby St, Houston, TX 77002"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: the matched address, 2010 and 2020 tracts, Opportunity Zone 1.0 and 2.0 status and NMTC eligibility; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The Census Geocoder could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "current designations, plus OZ 2.0 from January 1, 2027",
          "compare": "addresses (up to 10)",
          "place": "address",
          "segment": null
        }
      }
    },
    "/run/trade-area": {
      "post": {
        "operationId": "runTradeArea",
        "summary": "Who lives within a few miles of this site? Population, households, mean household income, owner and renter shares, and the count of public schools within a radius of a site, from ACS 5-year block groups (centroid allocation) and NCES 2024-25 school locations.",
        "description": "Population, households, mean household income, owner and renter shares, and the count of public schools within a radius of a site, from ACS 5-year block groups (centroid allocation) and NCES 2024-25 school locations. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH trade-area run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 120
                  },
                  "lat": {
                    "type": "number",
                    "minimum": 17,
                    "maximum": 72
                  },
                  "lon": {
                    "type": "number",
                    "minimum": -180,
                    "maximum": -64
                  },
                  "radius_miles": {
                    "type": "number",
                    "minimum": 0.5,
                    "maximum": 10
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "address": "901 Bagby St, Houston, TX 77002",
                "radius_miles": 3
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: Within 3 miles of 901 Bagby St, Houston, TX 77002: population, households, mean household income, owner and renter shares, density and public schools; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "A Census or NCES service could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one release (ACS 5-year)",
          "compare": null,
          "place": "address or lat/lon, radius_miles",
          "segment": null
        }
      }
    },
    "/run/parcel-mix": {
      "post": {
        "operationId": "runParcelMix",
        "summary": "What is the land around this Houston-area site used for? Harris County, Texas only: the parcels within a radius of a site by land-use category (Texas property class), with parcel counts, appraised value, the vacant share and the site parcel’s own class. Never owner names.",
        "description": "Harris County, Texas only: the parcels within a radius of a site by land-use category (Texas property class), with parcel counts, appraised value, the vacant share and the site parcel’s own class. Never owner names. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH parcel-mix run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 120
                  },
                  "lat": {
                    "type": "number",
                    "minimum": 17,
                    "maximum": 72
                  },
                  "lon": {
                    "type": "number",
                    "minimum": -180,
                    "maximum": -64
                  },
                  "radius_miles": {
                    "type": "number",
                    "minimum": 0.1,
                    "maximum": 1
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "address": "901 Bagby St, Houston, TX 77002",
                "radius_miles": 0.5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: Within 0.5 miles of 901 Bagby St, Houston, TX 77002 (Harris County): parcels and appraised value by land-use category, the vacant share and the site parcel’s class; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The HCAD parcel service could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one release (current appraisal year)",
          "compare": null,
          "place": "address or lat/lon, radius_miles (Harris County)",
          "segment": "land-use category (in the result)"
        }
      }
    },
    "/run/audience-size": {
      "post": {
        "operationId": "runAudienceSize",
        "summary": "What is the size of this audience profile? How many people or households in the US, a state or a set of PUMAs match a profile (age, sex, income, education, employment, tenure, children, occupation), from the 2024 ACS microdata with a 90% margin of error.",
        "description": "How many people or households in the US, a state or a set of PUMAs match a profile (age, sex, income, education, employment, tenure, children, occupation), from the 2024 ACS microdata with a 90% margin of error. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH audience-size run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "unit": {
                    "type": "string",
                    "enum": [
                      "persons",
                      "households"
                    ]
                  },
                  "state": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 2
                  },
                  "pumas": {
                    "type": "array",
                    "maxItems": 10,
                    "items": {
                      "type": "string",
                      "pattern": "^\\d{5}$"
                    }
                  },
                  "age_min": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 99
                  },
                  "age_max": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 99
                  },
                  "sex": {
                    "type": "string",
                    "enum": [
                      "male",
                      "female"
                    ]
                  },
                  "household_income_min": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "household_income_max": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "personal_income_min": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "personal_income_max": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "education": {
                    "type": "string",
                    "enum": [
                      "high_school",
                      "bachelors",
                      "graduate"
                    ]
                  },
                  "employed": {
                    "type": "boolean"
                  },
                  "tenure": {
                    "type": "string",
                    "enum": [
                      "owner",
                      "renter"
                    ]
                  },
                  "children": {
                    "type": "boolean"
                  },
                  "occupations": {
                    "type": "array",
                    "maxItems": 5,
                    "items": {
                      "type": "string",
                      "pattern": "^\\d{4}$"
                    }
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "unit": "households",
                "state": "TX",
                "tenure": "owner",
                "household_income_min": 150000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: The estimated count of households owning, household income $150,000-$9,999,999, its 90% margin of error, the share of the area and the sample size; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The Census API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one release (ACS 2024)",
          "compare": null,
          "place": "state or pumas",
          "segment": "age, sex, income, education, employed, tenure, children, occupations"
        }
      }
    },
    "/run/audience-map": {
      "post": {
        "operationId": "runAudienceMap",
        "summary": "Where does this audience live? Where households of a given householder age and income live: the counties of a state or the tracts of a county, ranked by count and by concentration, from ACS 2020-2024 5-year table B19037.",
        "description": "Where households of a given householder age and income live: the counties of a state or the tracts of a county, ranked by count and by concentration, from ACS 2020-2024 5-year table B19037. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH audience-map run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "state": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 2
                  },
                  "county": {
                    "type": "string",
                    "pattern": "^\\d{3}$"
                  },
                  "age_bands": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "under25",
                        "25to44",
                        "45to64",
                        "65plus"
                      ]
                    }
                  },
                  "income_min": {
                    "type": "integer"
                  },
                  "income_max": {
                    "type": "integer"
                  }
                },
                "required": [
                  "state"
                ],
                "additionalProperties": false
              },
              "example": {
                "state": "TX",
                "age_bands": [
                  "25to44"
                ],
                "income_min": 150000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: The counties ranked by count and by concentration of the audience, with shares, an index and margins of error; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The Census API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one release (ACS 2020-2024)",
          "compare": null,
          "place": "state (counties) or county (tracts)",
          "segment": "age_bands, income_min-income_max"
        }
      }
    },
    "/run/business-universe": {
      "post": {
        "operationId": "runBusinessUniverse",
        "summary": "Which businesses make up this industry here, and how big are they? For a NAICS industry in the US, a state, county, metro or ZIP: employer establishments, employees and payroll, establishments by employee size, and solo businesses with no payroll.",
        "description": "For a NAICS industry in the US, a state, county, metro or ZIP: employer establishments, employees and payroll, establishments by employee size, and solo businesses with no payroll. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH business-universe run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "naics": {
                    "type": "string",
                    "pattern": "^\\d{2,6}$"
                  },
                  "state": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 2
                  },
                  "county": {
                    "type": "string",
                    "pattern": "^\\d{3}$"
                  },
                  "cbsa": {
                    "type": "string",
                    "pattern": "^\\d{5}$"
                  },
                  "zip": {
                    "type": "string",
                    "pattern": "^\\d{5}$"
                  }
                },
                "required": [
                  "naics"
                ],
                "additionalProperties": false
              },
              "example": {
                "naics": "541211",
                "state": "TX"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: employer establishments, employees and payroll, the split by size, and solo firms with receipts; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The Census API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one release (latest County Business Patterns and Nonemployer year)",
          "compare": null,
          "place": "state, county, cbsa or zip",
          "segment": "naics; size class (in the result)"
        }
      }
    },
    "/run/buyer-roles": {
      "post": {
        "operationId": "runBuyerRoles",
        "summary": "Who holds this job here: how many, and at what pay? How many people hold a job (SOC occupation) in the US, a state or a metro, their mean and median pay, and how concentrated the job is there against the nation, from the latest May OEWS estimates.",
        "description": "How many people hold a job (SOC occupation) in the US, a state or a metro, their mean and median pay, and how concentrated the job is there against the nation, from the latest May OEWS estimates. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH buyer-roles run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "soc": {
                    "type": "string",
                    "pattern": "^\\d{2}-\\d{4}$"
                  },
                  "state": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 2
                  },
                  "cbsa": {
                    "type": "string",
                    "pattern": "^\\d{5}$"
                  }
                },
                "required": [
                  "soc"
                ],
                "additionalProperties": false
              },
              "example": {
                "soc": "11-2021",
                "cbsa": "26420"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: employment, mean and median annual wage, jobs per 1,000 and the location quotient; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The BLS API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one release (latest May OEWS)",
          "compare": null,
          "place": "state or cbsa",
          "segment": "soc (occupation)"
        }
      }
    },
    "/run/wallet-size": {
      "post": {
        "operationId": "runWalletSize",
        "summary": "What do households spend on this category? US household spending on a category: the mean per consumer unit, the total market in dollars, and the split by income, age, household size or family type, from the BLS Consumer Expenditure Survey.",
        "description": "US household spending on a category: the mean per consumer unit, the total market in dollars, and the split by income, age, household size or family type, from the BLS Consumer Expenditure Survey. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH wallet-size run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "item": {
                    "type": "string",
                    "enum": [
                      "FOODHOME",
                      "FOODAWAY",
                      "ALCBEVG",
                      "NALCBEVG",
                      "HOUSING",
                      "UTILS",
                      "HHFURNSH",
                      "APPAREL",
                      "TRANS",
                      "VEHPURCH",
                      "HEALTH",
                      "ENTRTAIN",
                      "PETS",
                      "PERSCARE",
                      "READING",
                      "EDUCATN",
                      "TOBACCO",
                      "CASHCONT",
                      "INSPENSN",
                      "TOTALEXP"
                    ]
                  },
                  "by": {
                    "type": "string",
                    "enum": [
                      "income",
                      "age",
                      "household_size",
                      "family_type"
                    ]
                  }
                },
                "required": [
                  "item"
                ],
                "additionalProperties": false
              },
              "example": {
                "item": "FOODAWAY",
                "by": "income"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: US spending on food away from home: the mean per unit, the total market and the split by income with shares; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "The BLS API could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one release (latest Consumer Expenditure Survey)",
          "compare": null,
          "place": null,
          "segment": "by (income, age, household size, family type), item"
        }
      }
    },
    "/run/news-pulse": {
      "post": {
        "operationId": "runNewsPulse",
        "summary": "Is this in the news, is it spiking, and how is the tone moving? News coverage of a phrase over up to a year: articles by week, spike weeks, share of all monitored coverage, tone and its direction, the most frequent outlets and the top headlines with links.",
        "description": "News coverage of a phrase over up to a year: articles by week, spike weeks, share of all monitored coverage, tone and its direction, the most frequent outlets and the top headlines with links. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH news-pulse run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "days": {
                    "type": "integer",
                    "minimum": 7,
                    "maximum": 365
                  }
                },
                "required": [
                  "query"
                ],
                "additionalProperties": false
              },
              "example": {
                "query": "Kraft Heinz",
                "days": 90
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: articles by week, spike weeks, share of coverage, tone and its direction, top outlets and headlines with links; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "GDELT could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: by week over days",
          "compare": null,
          "place": null,
          "segment": null
        }
      }
    },
    "/run/news-share-of-voice": {
      "post": {
        "operationId": "runNewsShareOfVoice",
        "summary": "Who is getting the most news coverage, and in what tone? Share of news coverage among 2-3 names (brands, companies, people, products) over up to 90 days, with each one's tone and busiest week.",
        "description": "Share of news coverage among 2-3 names (brands, companies, people, products) over up to 90 days, with each one's tone and busiest week. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH news-share-of-voice run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "names": {
                    "type": "array",
                    "minItems": 2,
                    "maxItems": 3,
                    "items": {
                      "type": "string",
                      "minLength": 3,
                      "maxLength": 80
                    }
                  },
                  "days": {
                    "type": "integer",
                    "minimum": 7,
                    "maximum": 90
                  }
                },
                "required": [
                  "names"
                ],
                "additionalProperties": false
              },
              "example": {
                "names": [
                  "Coca-Cola",
                  "PepsiCo"
                ],
                "days": 30
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: articles, share of coverage, tone and busiest week each; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "GDELT could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: busiest week over days",
          "compare": "names (2-3)",
          "place": null,
          "segment": null
        }
      }
    },
    "/run/social-pulse": {
      "post": {
        "operationId": "runSocialPulse",
        "summary": "Are people talking about this online, and is it spiking? Discussion of a phrase on Hacker News and Bluesky over up to 90 days: mentions by week on each, spike weeks, and the top Hacker News stories by points. Counts only from Bluesky.",
        "description": "Discussion of a phrase on Hacker News and Bluesky over up to 90 days: mentions by week on each, spike weeks, and the top Hacker News stories by points. Counts only from Bluesky. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH social-pulse run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "days": {
                    "type": "integer",
                    "minimum": 7,
                    "maximum": 90
                  }
                },
                "required": [
                  "query"
                ],
                "additionalProperties": false
              },
              "example": {
                "query": "Model Context Protocol",
                "days": 30
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: weekly mentions on Hacker News and Bluesky, spike weeks and the top Hacker News stories; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "Hacker News or Bluesky could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "built in: by week over days",
          "compare": null,
          "place": null,
          "segment": "platform (Hacker News, Bluesky)"
        }
      }
    },
    "/run/social-share-of-voice": {
      "post": {
        "operationId": "runSocialShareOfVoice",
        "summary": "Which of these names do people discuss most online? Share of discussion among 2-4 names on Hacker News and Bluesky over up to 90 days. Counts only.",
        "description": "Share of discussion among 2-4 names on Hacker News and Bluesky over up to 90 days. Counts only. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH social-share-of-voice run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "names": {
                    "type": "array",
                    "minItems": 2,
                    "maxItems": 4,
                    "items": {
                      "type": "string",
                      "minLength": 3,
                      "maxLength": 80
                    }
                  },
                  "days": {
                    "type": "integer",
                    "minimum": 7,
                    "maximum": 90
                  }
                },
                "required": [
                  "names"
                ],
                "additionalProperties": false
              },
              "example": {
                "names": [
                  "Postgres",
                  "MySQL"
                ],
                "days": 30
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: Hacker News mentions and Bluesky posts, with shares; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "Hacker News or Bluesky could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "over days",
          "compare": "names (2-4)",
          "place": null,
          "segment": "platform (Hacker News, Bluesky)"
        }
      }
    },
    "/run/topic-views": {
      "post": {
        "operationId": "runTopicViews",
        "summary": "Which topics on this subject are getting views on YouTube? YouTube's most-viewed videos on a subject over up to 30 days, split by 2-4 title topics: videos, median views and median views per day for each topic, Shorts against long-form, and the share of views the top channels hold.",
        "description": "YouTube's most-viewed videos on a subject over up to 30 days, split by 2-4 title topics: videos, median views and median views per day for each topic, Shorts against long-form, and the share of views the top channels hold. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH topic-views run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80
                  },
                  "topics": {
                    "type": "array",
                    "minItems": 2,
                    "maxItems": 4,
                    "items": {
                      "type": "string",
                      "minLength": 2,
                      "maxLength": 40
                    }
                  },
                  "days": {
                    "type": "integer",
                    "minimum": 7,
                    "maximum": 30
                  }
                },
                "required": [
                  "query",
                  "topics"
                ],
                "additionalProperties": false
              },
              "example": {
                "query": "GTA 6",
                "topics": [
                  "trailer",
                  "leak",
                  "gameplay",
                  "price"
                ],
                "days": 30
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: videos, median views and views per day for each topic, Shorts against long-form, the top channels' share and the top 10 videos; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "YouTube could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one window of days; re-run for a later window",
          "compare": null,
          "place": null,
          "segment": "topics; Shorts against long-form"
        }
      }
    },
    "/run/channel-benchmark": {
      "post": {
        "operationId": "runChannelBenchmark",
        "summary": "Which of these YouTube channels gets more views, and from what? Up to 5 YouTube channels compared over 30-180 days: uploads a week, share of Shorts, median views for long-form and Shorts, views per day, likes and comments per 1,000 views, and how titles with chosen words perform.",
        "description": "Up to 5 YouTube channels compared over 30-180 days: uploads a week, share of Shorts, median views for long-form and Shorts, views per day, likes and comments per 1,000 views, and how titles with chosen words perform. If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH channel-benchmark run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "channels": {
                    "type": "array",
                    "minItems": 2,
                    "maxItems": 5,
                    "items": {
                      "type": "string",
                      "minLength": 4,
                      "maxLength": 31
                    }
                  },
                  "days": {
                    "type": "integer",
                    "minimum": 30,
                    "maximum": 180
                  },
                  "terms": {
                    "type": "array",
                    "maxItems": 4,
                    "items": {
                      "type": "string",
                      "minLength": 2,
                      "maxLength": 40
                    }
                  }
                },
                "required": [
                  "channels"
                ],
                "additionalProperties": false
              },
              "example": {
                "channels": [
                  "@mkbhd",
                  "@LinusTechTips"
                ],
                "days": 90
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: uploads a week, Shorts share, median views by format, views per day and engagement rates; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "YouTube could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one window of days",
          "compare": "channels (2-5)",
          "place": null,
          "segment": "format (Shorts, long-form); terms"
        }
      }
    },
    "/run/college-athletics": {
      "post": {
        "operationId": "runCollegeAthletics",
        "summary": "What does this college athletics program earn and spend, sport by sport, against its peers? One NCAA Division I athletics program's reported revenue and expenses (EADA, 2024-25), split into football, men's and women's basketball, other men's and women's sports and not allocated, with athletes per sport, ranked against its Division I classification or against 2-20 schools you name (e.g. a conference).",
        "description": "One NCAA Division I athletics program's reported revenue and expenses (EADA, 2024-25), split into football, men's and women's basketball, other men's and women's sports and not allocated, with athletes per sport, ranked against its Division I classification or against 2-20 schools you name (e.g. a conference). If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH college-athletics run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "school": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 100
                  },
                  "compare": {
                    "type": "array",
                    "minItems": 2,
                    "maxItems": 20,
                    "items": {
                      "type": "string",
                      "minLength": 3,
                      "maxLength": 100
                    }
                  }
                },
                "required": [
                  "school"
                ],
                "additionalProperties": false
              },
              "example": {
                "school": "University of Texas at Austin"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: revenue and expenses by football, basketball, other sports and not allocated; the football and men's basketball share; athletes per sport; its rank and the median against its Division I classification; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "EADA could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "one EADA data year",
          "compare": "compare (2-20 schools) or the school's Division I classification",
          "place": null,
          "segment": "sport; men and women (in the result)"
        }
      }
    },
    "/run/sports-business-benchmark": {
      "post": {
        "operationId": "runSportsBusinessBenchmark",
        "summary": "Which listed sports businesses are growing, making money and spending to acquire customers? US-listed sports businesses compared from their latest 10-K: revenue, revenue growth, operating margin, sales and marketing and advertising as a share of revenue, and the group medians. Groups: betting (DKNG, FLUT, CHDN, PENN, RSI), teams (MSGK, BATRA, TKO), live (LYV, SPHR, MSGE).",
        "description": "US-listed sports businesses compared from their latest 10-K: revenue, revenue growth, operating margin, sales and marketing and advertising as a share of revenue, and the group medians. Groups: betting (DKNG, FLUT, CHDN, PENN, RSI), teams (MSGK, BATRA, TKO), live (LYV, SPHR, MSGE). If its control fails it refuses and nothing is charged. Switched on separately: until it is, the endpoint answers 503 and charges nothing.",
        "x-payment-info": {
          "amount": "50",
          "currency": "usd",
          "intent": "charge",
          "method": "stripe",
          "description": "CULT+MATH sports-business-benchmark run"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "group": {
                    "type": "string",
                    "enum": [
                      "betting",
                      "teams",
                      "live"
                    ]
                  },
                  "tickers": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "group": "betting"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The run: revenue, growth, operating margin, sales and marketing and advertising intensity, the group medians and each row's filing; the controls; the limits; a run id and a cite_as line. A Payment-Receipt header names the payment."
          },
          "400": {
            "description": "The request is not a valid run."
          },
          "402": {
            "description": "Payment required: a WWW-Authenticate: Payment challenge, or a fresh one if the credential was refused."
          },
          "422": {
            "description": "The run failed its own controls. No result is given and nothing was charged."
          },
          "502": {
            "description": "SEC EDGAR could not be read. Nothing was charged."
          },
          "503": {
            "description": "Paid runs are not switched on. Nothing was charged."
          }
        },
        "x-dimensions": {
          "time": "latest fiscal year, with growth on the year before",
          "compare": "group or tickers (2-8)",
          "place": null,
          "segment": "metric (in the result)"
        }
      }
    }
  }
}
