A
licenseA
qualityC
maintenanceValidate AI claims against live data: check endpoints, count competitors, and test hypotheses. Includes free and paid tools via x402.
16
MIT
How To Make Money On Snapchat
Server Details
Two fact tools free, no key, low limit. Other tools: 14-day trial or paid plan. Watch writes data.
Ownership verified
- Status
- Healthy
- Uptime
- 100.0% over 23 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
A3.9/5.0
Scored across 8 tools
Disambiguation5/5
Each tool has a sharply distinct purpose, and the descriptions explicitly state when to use and when NOT to use each tool (e.g. calculate_gap vs calculate_growth_pace vs check_eligibility). The read/write split on the watch tools and the fact/calculation split on the rule tools further remove ambiguity.
Naming Consistency4/5
All names use snake_case and follow a predictable verb_noun shape (calculate_gap, get_rule_changes, check_eligibility). The only deviation is the watch_ resource namespace (watch_get_status, watch_save_checkin), which is a minor but sensible variation.
Tool Count5/5
Eight tools is well-scoped for a creator-monetization advisory domain. Every tool covers a distinct facet (rules, changes, eligibility, gap, pace, payout, watch read/write), so none feel redundant or filler.
Completeness4/5
The surface covers the full advisory lifecycle: fetch rules, detect changes, evaluate eligibility, compute shortfall and pace, project payouts, and track trends over time. Only minor gaps exist, such as no explicit way to list or delete watch check-ins beyond nulling fields.
Available Tools
8 toolscalculate_gapARead-onlyIdempotentInspect
CALCULATION. Use this when you need the exact numeric shortfall, percent complete, and binding constraint for a creator's caller-supplied metrics. Do not use it for the pace to close that gap (calculate_growth_pace) or for a per-requirement pass/fail list (check_eligibility).
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metrics | Yes | Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error. | |
| program | No | Programs the calculation tools evaluate in v1. Other in-scope programs (payouts, tax, snap_star, creator_monetization_policy, recommendation_eligibility, brand_partnerships) are served as FACTs by get_monetization_requirements; Snap Star status is evaluated as a prerequisite inside unified_monetization_program. | unified_monetization_program |
| already_enrolled | No | Set true only if the creator is already enrolled in the Monetization Program. Default false: only entry (invitation) requirements are evaluated. When true, ongoing requirements for enrolled creators are reported in a separate section. | |
| include_recommendations | No |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| gaps | Yes | Entry requirements only. |
| tool | Yes | |
| facts | Yes | |
| notice | Yes | Non-affiliation notice included in every response. |
| program | Yes | Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards. |
| sources | Yes | |
| unknowns | Yes | |
| warnings | No | Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning. |
| api_version | Yes | |
| generated_at | Yes | |
| ongoing_gaps | Yes | null unless already_enrolled=true. |
| data_freshness | Yes | |
| recommendations | Yes | |
| already_enrolled | Yes | |
| binding_constraint | Yes |
TDQS
A4.5/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover read-only, idempotent, non-destructive behavior. The description adds that metrics are caller-supplied, which is important behavioral context because it tells the agent not to expect external lookups. It does not repeat safety annotations or contradict them.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences, front-loaded with the purpose and immediately followed by routing exclusions. No repetitive or wasted phrasing.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the rich input schema, existing output schema, and read-only annotations, the description supplies exactly what an agent needs for selection and invocation. It names alternatives and clarifies the caller-supplied metrics model without needing to restate schema or return details.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds no parameter-level meaning; the schema carries the detail (75% coverage, nested metrics object with several field descriptions). Baseline 3 is appropriate when the schema does the heavy lifting and the description omits parameter semantics.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource (calculate exact numeric shortfall, percent complete, binding constraint) and explicitly distinguishes itself from two sibling tools by name. An agent can identify its role without opening schemas.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says when to use it and when not to, naming calculate_growth_pace for pace and check_eligibility for pass/fail lists. The alternative conditions are directly tied to user intent.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
calculate_growth_paceARead-onlyIdempotentInspect
CALCULATION. Use this when you need the daily and weekly pace to close each numeric gap within target_days, with scenarios and labeled assumptions. This is a projection, not a prediction. Do not use it to learn the size of the gap (calculate_gap) or to list the rules (get_monetization_requirements).
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metrics | Yes | Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error. | |
| program | No | Programs the calculation tools evaluate in v1. Other in-scope programs (payouts, tax, snap_star, creator_monetization_policy, recommendation_eligibility, brand_partnerships) are served as FACTs by get_monetization_requirements; Snap Star status is evaluated as a prerequisite inside unified_monetization_program. | unified_monetization_program |
| target_days | Yes | ||
| metrics_to_pace | No | ||
| already_enrolled | No | Set true only if the creator is already enrolled in the Monetization Program. Default false: only entry (invitation) requirements are evaluated. When true, ongoing requirements for enrolled creators are reported in a separate section. | |
| observed_daily_change | No | Optional recent average daily change per metric (caller-supplied, may be negative) for comparing required vs. current pace. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| tool | Yes | |
| facts | Yes | |
| paces | Yes | Entry requirements only. |
| notice | Yes | Non-affiliation notice included in every response. |
| program | Yes | Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards. |
| sources | Yes | |
| unknowns | Yes | |
| warnings | No | Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning. |
| api_version | Yes | |
| target_date | Yes | |
| target_days | Yes | |
| generated_at | Yes | |
| ongoing_paces | Yes | null unless already_enrolled=true. |
| data_freshness | Yes | |
| recommendations | Yes | |
| already_enrolled | Yes | |
| projection_disclaimer | Yes |
TDQS
A4.3/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover the safety profile (readOnlyHint, idempotent, non-destructive, closed-world), so the bar is lower. The description still adds interpretive context the annotations cannot: it is a projection not a prediction, produces scenarios, and labels assumptions — useful for how an agent should present results. It does not discuss error modes or the plausibility warnings that live only in the schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences, front-loaded with the purpose before the exclusions, and every sentence carries distinct information with no repetition of the title.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
A dedicated output schema exists, so return-value explanation is unnecessary, and the description covers purpose, caveat (projection), and routing. The remaining shortfall is parameter-level coverage for target_days and metrics_to_pace, which is left to the schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters2/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 67%; the description adds no parameter detail of its own beyond embedding target_days in a sentence. Two parameters (target_days, metrics_to_pace) carry no schema description either, and the description does not compensate — it never explains the units or the array-of-metrics selection semantics.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and output (daily and weekly pace to close each numeric gap within target_days), plus the scenario/assumption framing. It explicitly distinguishes itself from calculate_gap and get_monetization_requirements, so an agent can route without opening sibling schemas.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives an explicit when-to-use ('when you need the daily and weekly pace to close each numeric gap within target_days') and explicit when-not-to-use clauses naming the two sibling alternatives by name. Nothing is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
calculate_payout_timelineARead-onlyIdempotentInspect
CALCULATION. Use this when you need a date-by-date timeline of Snap's payout steps from a credited date: Pending to Available, the cash-out minimum, taxpayer verification, and the earliest day cash can reach the Payout Portal. Ranges stay ranges when the source gives a range. This is an estimate, not a promise. Do not use it to score eligibility (check_eligibility) or to list every rule (get_monetization_requirements).
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount_usd | No | Available balance in USD, supplied by the caller. Omitted when unknown. Compared with the cash-out minimum from the rules database. Not a Snap pay rate. | |
| credited_date | Yes | The day the reward appeared in All Activity, which is when Snap starts the pending clock. YYYY-MM-DD. | |
| tax_info_verified | No | True when the caller says taxpayer verification is already finished. False when it is not. Omit when unknown. This service does not check a Snap account. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| tool | Yes | |
| facts | Yes | |
| steps | Yes | |
| notice | Yes | Non-affiliation notice included in every response. |
| caveats | Yes | |
| sources | Yes | |
| warnings | No | Plain strings. Omitted when empty. |
| amount_usd | Yes | |
| api_version | Yes | |
| generated_at | Yes | |
| credited_date | Yes | |
| meets_minimum | Yes | True when amount_usd meets the cash-out minimum. False when it does not. Null when amount_usd was omitted. |
| shortfall_usd | Yes | How far amount_usd is under the cash-out minimum. 0 when the minimum is met. Null when amount_usd was omitted. |
| data_freshness | Yes | |
| recommendations | Yes | |
| tax_info_verified | Yes | |
| estimate_disclaimer | Yes | |
| cash_out_minimum_usd | Yes | The cash-out minimum copied from the rules database. |
TDQS
A4.4/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, non-destructive, and closed-world, so the safety profile is covered. The description adds genuinely new behavioral context: it is an estimate rather than a guarantee, ranges are preserved rather than collapsed, and it does not look up an account. It stops short of stating determinism guarantees or the shape of the range/estimate output, but for a read-only calculator this is solid added value.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness4/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the operation type and the core use case, and each following sentence adds a distinct fact (coverage list, range preservation, estimate caveat, exclusions). The leading 'CALCULATION.' stub is slightly redundant with the name, and the coverage list is dense, but nothing is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, return values need not be explained, and the description covers trigger, scope, caveats, and exclusions. An agent has everything needed to choose this over its siblings and call it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and each parameter already documents its meaning, including the note that amount_usd is not a Snap pay rate and that tax_info_verified does not query an account. The description restates the cash-out-minimum comparison and verification flag without adding syntax or interpretation beyond the schema, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource ('date-by-date timeline of Snap's payout steps from a credited date') and enumerates the exact stages covered (Pending to Available, cash-out minimum, taxpayer verification, Payout Portal). It also explicitly names the sibling tools it is not, so it is distinguishable without opening any schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives an explicit trigger ('Use this when you need a date-by-date timeline...') and explicit exclusions with named alternatives ('Do not use it to score eligibility (check_eligibility) or to list every rule (get_monetization_requirements)'). This is exactly the when/when-not/alternative pattern.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
check_eligibilityARead-onlyIdempotentInspect
CALCULATION. Use this to compare one creator's caller-supplied metrics with the published entry requirements. Returns published_criteria_status of meets_published_criteria, does_not_meet_published_criteria, or unknown, plus pass/fail/unknown per requirement. Do not use it when you need the numeric shortfall (calculate_gap) or the rules without a creator (get_monetization_requirements).
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metrics | Yes | Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error. | |
| program | No | Programs the calculation tools evaluate in v1. Other in-scope programs (payouts, tax, snap_star, creator_monetization_policy, recommendation_eligibility, brand_partnerships) are served as FACTs by get_monetization_requirements; Snap Star status is evaluated as a prerequisite inside unified_monetization_program. | unified_monetization_program |
| confirmations | No | Caller's answers to qualitative requirements (requires_user_confirmation rules), keyed by rule id. We record the answer as given and never verify it. | |
| metrics_as_of | No | Date the metrics were read from Insights. | |
| already_enrolled | No | Set true only if the creator is already enrolled in the Monetization Program. Default false: only entry (invitation) requirements are evaluated. When true, ongoing requirements for enrolled creators are reported in a separate section. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| tool | Yes | |
| facts | Yes | |
| notice | Yes | Non-affiliation notice included in every response. |
| program | Yes | Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards. |
| sources | Yes | |
| summary | Yes | Entry requirements only. published_criteria_status rule: does_not_meet_published_criteria if any requirement is fail or user_denied; otherwise unknown if any is unknown or requires_user_confirmation; otherwise meets_published_criteria. There is deliberately no 'eligible' verdict. |
| unknowns | Yes | |
| warnings | No | Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning. |
| api_version | Yes | |
| generated_at | Yes | |
| requirements | Yes | |
| data_freshness | Yes | |
| already_enrolled | Yes | |
| ongoing_requirements | Yes | null unless already_enrolled=true. |
TDQS
A4.4/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), so the bar is lower. The description still adds that inputs are caller-supplied metrics rather than server lookups and that it does not return an eligible verdict, which is useful context beyond the annotations. It omits auth/permission and plausibility-warning behavior, which lives only in the schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loads the tool category, then use case, then return values, then exclusions in three tight sentences with zero filler. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return-value explanation is not required, and the description stays focused on purpose, routing, and result semantics. For a complex nested-input tool, it does not mention the qualitative confirmations flow, but the schema covers that thoroughly, so the gap is minor.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the nested metrics object documents every field, its ranges, and plausibility rules. The description adds no parameter-level syntax or format detail beyond the schema, so the baseline 3 is correct.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource: compare one creator's caller-supplied metrics against published entry requirements. It also names the exact return field and its three possible values, so an agent knows precisely what it produces before opening the output schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly routes the agent away from this tool with named alternatives and the condition that selects them: calculate_gap for numeric shortfall, get_monetization_requirements for rules without a creator. When/when-not guidance is complete.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_monetization_requirementsARead-onlyIdempotentInspect
FACT. Use this first when you need Snap's published creator-monetization rules themselves: thresholds, country lists, policy text, source URL, verified_at, and effective date. Do not use it to score one creator or to compute a shortfall. For a creator's numbers, use check_eligibility or calculate_gap. When a response includes an upgrade object, tell the user that message and the pricing URL.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | Return the rules that were in force on this date (uses version history). Default: today. | |
| country | No | ISO 3166-1 alpha-2, alpha-3, or an English country name. Adds country_eligibility. Does not remove facts. | |
| program | No | Limit to one program. Omit for all programs. | |
| requirement_phase | No | Optional filter. | |
| include_historical | No | ||
| include_unverified | No | Include rules we could not verify (status=unverified). Default true so gaps in knowledge are visible. | |
| include_out_of_scope | No | Include programs outside the MVP scope (e.g., lens_creator_rewards, creator_subscriptions). Default false. Requesting an out-of-scope program with this false returns PROGRAM_OUT_OF_SCOPE. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| tool | Yes | |
| facts | Yes | |
| query | No | Echo of the effective filters. |
| notice | Yes | Non-affiliation notice included in every response. |
| sources | Yes | |
| upgrade | No | Present on unpaid fact-tool responses and on HTTP 401, 402, and anonymous 429. The agent should tell the user this message. The price is the Personal plan price from the pricing page. |
| programs | Yes | |
| warnings | No | Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning. |
| api_version | Yes | |
| generated_at | Yes | |
| catalog_scope | No | Counts computed from the approved rules database for one as-of date. mvp_in_force is the default requirements list. in_force_including_out_of_scope adds programs stored as out of scope. mvp_including_historical is every in-scope record, which is what the rule-change log lists. |
| direct_answer | No | Answer-first lead built from entry-requirement facts included in this response. Omitted when those facts are absent. |
| data_freshness | Yes | |
| direct_answer_note | No | Optional sentence after the lead for unverified entry facts left out of it. Omitted when there are none. |
| country_eligibility | No |
TDQS
A4.3/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly/idempotent/non-destructive/closed-world, so safety is covered. The description adds real behavioral context: it labels itself a FACT source (rules, not derived scores) and instructs the agent to surface an 'upgrade' object plus its pricing URL to the user, which is non-obvious output-handling behavior. It does not discuss pagination or failure modes, keeping it short of a 5.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness4/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Four tight sentences, front-loaded with the routing decision before the alternative tools. Every sentence carries routing or output-handling information; the terse 'FACT.' opener is efficient but slightly opaque on its own.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, return values need no explanation, and annotations cover the safety profile. The description covers purpose, routing, and a non-obvious post-call behavior; only edge-case guidance (e.g., UNKNOWN_PROGRAM or PROGRAM_OUT_OF_SCOPE handling) is left entirely to the schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 86%, so the schema already explains as_of, country, program, and the include_* flags including defaults and error codes. The description adds no parameter-level syntax or semantics beyond that, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource (returns Snap's published creator-monetization rules) and enumerates the payload (thresholds, country lists, policy text, source URL, verified_at, effective date). It also explicitly distinguishes itself from check_eligibility and calculate_gap, so an agent can route without opening any schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives an explicit trigger ('Use this first when you need ... the rules themselves'), an explicit exclusion ('Do not use it to score one creator or to compute a shortfall'), and names the two alternatives for that case. When/when-not/alternative are all present.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_rule_changesARead-onlyIdempotentInspect
FACT. Use this when you need what changed in Snap's monetization rules since a date: previous value, new value, source, and the date we detected the change. Do not use it for the current rule list (get_monetization_requirements) or for a creator's gap (calculate_gap). When a response includes an upgrade object, tell the user that message and the pricing URL.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| since | No | Inclusive lower bound on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at. Omitted on GET, POST, and MCP means 90 days before the request's UTC date. until defaults to the UTC date of the request. The response echoes both dates at the top level and inside query. | |
| until | No | Inclusive upper bound on that same change date. Default: the UTC date of the request. | |
| cursor | No | Opaque pagination cursor from a previous response. | |
| program | No | Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards. | |
| include_baseline | No | When true, also return baseline records in baseline. Baseline records are never included in changes. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| tool | Yes | |
| query | Yes | Filters applied to this response, including defaults. Top-level since and until stay for older clients. |
| since | Yes | |
| until | Yes | |
| notice | Yes | Non-affiliation notice included in every response. |
| changes | Yes | |
| sources | Yes | |
| upgrade | No | Present on unpaid fact-tool responses and on HTTP 401, 402, and anonymous 429. The agent should tell the user this message. The price is the Personal plan price from the pricing page. |
| baseline | No | Initial-load records. Present only when include_baseline is true. Never included in changes or in change counts. |
| warnings | No | Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning. |
| api_version | Yes | |
| next_cursor | Yes | |
| generated_at | Yes | |
| catalog_scope | No | Counts computed from the approved rules database for one as-of date. mvp_in_force is the default requirements list. in_force_including_out_of_scope adds programs stored as out of scope. mvp_including_historical is every in-scope record, which is what the rule-change log lists. |
| data_freshness | Yes |
TDQS
A4.5/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false, so the safety profile is covered. The description adds real value beyond them: the shape of the change record (old value, new value, source, detection date) and a downstream behavioral instruction about the upgrade object (surface its message and pricing URL to the user). It stops short of describing pagination or the default 90-day window, which live only in the schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three front-loaded sentences: purpose, then the when/when-not routing, then one non-obvious output directive. No filler, no restatement of the tool name or schema fields.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be enumerated — yet the description still flags the upgrade object handling, which no structured field carries. Combined with clear tool-selection guidance and annotation-covered safety, an agent has everything needed to call this correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 83% and the schema itself documents since/until filtering precedence in detail, so the baseline is 3. The description only loosely gestures at the date parameter ('since a date') and adds no format or boundary guidance beyond what the schema already states.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
Specific verb+resource: it lists what changed in Snap's monetization rules and enumerates the returned fields (previous value, new value, source, detection date). It also explicitly names the two siblings it is not (get_monetization_requirements for the current list, calculate_gap for a creator's gap), so an agent can route without opening any schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives an explicit when ('when you need what changed since a date') plus explicit when-not clauses tied to two named alternatives. Nothing about tool selection is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
watch_get_statusCRead-onlyIdempotentInspect
READ. Return this key's Eligibility Watch trend, projected dates, and rule-change notes. It does not write.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profile_id | No | ||
| already_enrolled | No |
TDQS
C2.8/5.0
Behavior2/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so 'It does not write' merely restates structured data and earns no credit. No additional behavioral context (auth needs, freshness of projections, caching) is provided beyond the safety profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three terse sentences with the mode marker and the returned payload front-loaded; every clause carries information and nothing is padded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness2/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no output schema and zero parameter documentation, the description should at minimum explain what already_enrolled does and when each state applies. It covers the payload at a high level but leaves the invocation semantics incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters2/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description carries the full burden for both parameters. 'This key's' loosely implies profile_id identifies the watch key, but already_enrolled is never explained, leaving half the parameters undocumented anywhere.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose4/5
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (return) and a concrete payload (Eligibility Watch trend, projected dates, rule-change notes), which is more specific than the title. It distinguishes itself from write siblings via 'It does not write' but never names an alternative tool, so it stops short of full sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines2/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use guidance and no alternatives named. The agent is left to infer from 'READ' that this is the retrieval counterpart to watch_save_checkin, but nothing states when to prefer it over check_eligibility or get_rule_changes.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
watch_save_checkinADestructiveIdempotentInspect
WRITE. Save caller-supplied Snapchat numbers on this key's Eligibility Watch. A field you include replaces that date. A field you omit keeps the saved value. Null clears it.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | Yes | ||
| metrics | Yes | ||
| profile | No | ||
| profile_id | No |
TDQS
A3.7/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare destructiveHint=true and idempotentHint=true, so the safety profile is covered. The description adds genuinely new context by specifying the merge semantics: included fields replace, omitted fields persist, and null clears. That explains exactly what gets overwritten and how, which the annotations alone do not convey. It stops short of noting auth or key-scoping requirements.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Four short sentences, front-loaded with the operation type and target, with each subsequent sentence adding a distinct semantic rule. No filler or repetition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness3/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a destructive mutation tool, the description usefully covers merge/clear semantics, and no output schema means return values need not be explained. But with four parameters at 0% schema coverage and nested objects, the unexplained profile/profile_id parameters and the unstated key identity leave real gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage, the description must carry the load, and it does explain the replace/omit/null behavior of the nested metric fields and the date field. However, the top-level 'profile' and 'profile_id' parameters, and what 'this key' refers to, are never addressed, leaving half the parameters undocumented in both schema and description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose4/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource ('Save caller-supplied Snapchat numbers on this key's Eligibility Watch') and leads with 'WRITE', which implicitly contrasts with the read counterpart watch_get_status. It is clear what the tool does, though it never names a sibling explicitly, so the differentiation is inferred rather than stated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines3/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The 'WRITE' marker and the save framing imply this is the mutation entry point for a key's eligibility watch, but there is no explicit statement of when to use it versus watch_get_status or check_eligibility, and no prerequisites or exclusions. Usage is implied, not guided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- Changed
get_rule_changes3 fields changed- changed
Input schema / descriptionPrevious value: -"FACT tool. Lists approved changes to Snap monetization rules. A change is a record that supersedes an approved earlier record and differs in value, status, or source, or a record with an explicit approved change block (added or retired). Baseline records (no supersedes and no change block) are omitted unless include_baseline is true, and they are never included in changes or in change counts. since and until filter on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at. They do not filter on verified_at."New value: +"FACT tool. Lists approved changes to Snap monetization rules. A change is a record that supersedes an approved earlier record and differs in value, status, or source, or a record with an explicit approved change block (added, retired, or claim_changed). claim_changed is a superseding record whose claim changed while value, status, and source stayed the same. A superseding record that keeps value, status, and source and does not set claim_changed is a date-presentation successor: the earlier record remains the published change. Baseline records (no supersedes and no change block) are omitted unless include_baseline is true, and they are never included in changes or in change counts. since and until filter on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at. They do not filter on verified_at." - changed
Output schema / properties / changes / items / properties / change_type / descriptionPrevious value: -"How this record differs from the approved record it supersedes, or the type on an explicit change block. Baseline records are returned only in baseline."New value: +"How this record differs from the approved record it supersedes, or the type on an explicit change block. claim_changed means the claim changed and the value, status, and source did not. Baseline records are returned only in baseline." - changed
Output schema / properties / changes / items / properties / change_type / enumPrevious value: -[ - "added", - "value_changed", - "status_changed", - "retired", - "source_changed", - "baseline" -]New value: +[ + "added", + "value_changed", + "status_changed", + "retired", + "source_changed", + "claim_changed", + "baseline" +]
2 tool updates
- Changed
get_monetization_requirements1 field changed- added
Output schema / properties / upgradeAdded value: +{ + "additionalProperties": false, + "description": "Present on unpaid fact-tool responses and on HTTP 401, 402, and anonymous 429. The agent should tell the user this message. The price is the Personal plan price from the pricing page.", + "properties": { + "message": { + "minLength": 1, + "type": "string" + }, + "url": { + "const": "https://howtomakemoneyonsnapchat.com/pricing", + "format": "uri", + "type": "string" + } + }, + "required": [ + "message", + "url" + ], + "type": "object" +}
- Changed
get_rule_changes1 field changed- added
Output schema / properties / upgradeAdded value: +{ + "additionalProperties": false, + "description": "Present on unpaid fact-tool responses and on HTTP 401, 402, and anonymous 429. The agent should tell the user this message. The price is the Personal plan price from the pricing page.", + "properties": { + "message": { + "minLength": 1, + "type": "string" + }, + "url": { + "const": "https://howtomakemoneyonsnapchat.com/pricing", + "format": "uri", + "type": "string" + } + }, + "required": [ + "message", + "url" + ], + "type": "object" +}
2 tool updates
- Added
watch_get_status - Added
watch_save_checkin
1 tool update
- Added
calculate_payout_timeline
5 tool updates
- Changed
calculate_gap7 fields changed- changed
Output schema / allOfPrevious value: -[ - { - "description": "Fields present in every successful tool output.", - "properties": { - "api_version": { - "const": "v1" - }, - "data_freshness": { - "additionalProperties": false, - "properties": { - "generated_at": { - "format": "date-time", - "type": "string" - }, - "newest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "oldest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "policy": { - "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", - "type": "string" - }, - "rules_db_version": { - "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", - "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", - "type": "string" - }, - "stale_rule_ids": { - "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "rules_db_version", - "generated_at", - "oldest_verified_at", - "newest_verified_at", - "stale_rule_ids", - "policy" - ], - "type": "object" - }, - "generated_at": { - "format": "date-time", - "type": "string" - }, - "notice": { - "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", - "description": "Non-affiliation notice included in every response.", - "type": "string" - }, - "sources": { - "items": { - "additionalProperties": false, - "properties": { - "publisher": { - "type": "string" - }, - "supports_rule_ids": { - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "url": { - "format": "uri", - "type": "string" - }, - "verified_at": { - "format": "date", - "type": "string" - } - }, - "required": [ - "url", - "publisher", - "verified_at", - "supports_rule_ids" - ], - "type": "object" - }, - "type": "array" - }, - "tool": { - "type": "string" - }, - "warnings": { - "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "tool", - "api_version", - "notice", - "generated_at", - "sources", - "data_freshness" - ], - "type": "object" - } -]New value: +[ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_last_checked_at": { + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_last_checked_at": { + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "last_checked_at": { + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" + }, + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } +] - added
Output schema / properties / data_freshness / properties / newest_last_checked_atAdded value: +{ + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" +} - added
Output schema / properties / data_freshness / properties / oldest_last_checked_atAdded value: +{ + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" +} - changed
Output schema / properties / data_freshness / properties / policy / descriptionPrevious value: -"Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'"New value: +"Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'" - changed
Output schema / properties / data_freshness / properties / stale_rule_ids / descriptionPrevious value: -"Rules in this response whose verified_at is older than the staleness window stated in `policy`."New value: +"Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count." - added
Output schema / properties / facts / items / properties / last_checked_atAdded value: +{ + "description": "ISO-8601 timestamp of the latest automated check that found this rule's official source text unchanged. Omitted when no such check is recorded. Does not replace verified_at and is not a rule value.", + "format": "date-time", + "type": "string" +} - added
Output schema / properties / sources / items / properties / last_checked_atAdded value: +{ + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" +}
- Changed
calculate_growth_pace7 fields changed- changed
Output schema / allOfPrevious value: -[ - { - "description": "Fields present in every successful tool output.", - "properties": { - "api_version": { - "const": "v1" - }, - "data_freshness": { - "additionalProperties": false, - "properties": { - "generated_at": { - "format": "date-time", - "type": "string" - }, - "newest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "oldest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "policy": { - "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", - "type": "string" - }, - "rules_db_version": { - "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", - "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", - "type": "string" - }, - "stale_rule_ids": { - "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "rules_db_version", - "generated_at", - "oldest_verified_at", - "newest_verified_at", - "stale_rule_ids", - "policy" - ], - "type": "object" - }, - "generated_at": { - "format": "date-time", - "type": "string" - }, - "notice": { - "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", - "description": "Non-affiliation notice included in every response.", - "type": "string" - }, - "sources": { - "items": { - "additionalProperties": false, - "properties": { - "publisher": { - "type": "string" - }, - "supports_rule_ids": { - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "url": { - "format": "uri", - "type": "string" - }, - "verified_at": { - "format": "date", - "type": "string" - } - }, - "required": [ - "url", - "publisher", - "verified_at", - "supports_rule_ids" - ], - "type": "object" - }, - "type": "array" - }, - "tool": { - "type": "string" - }, - "warnings": { - "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "tool", - "api_version", - "notice", - "generated_at", - "sources", - "data_freshness" - ], - "type": "object" - } -]New value: +[ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_last_checked_at": { + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_last_checked_at": { + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "last_checked_at": { + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" + }, + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } +] - added
Output schema / properties / data_freshness / properties / newest_last_checked_atAdded value: +{ + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" +} - added
Output schema / properties / data_freshness / properties / oldest_last_checked_atAdded value: +{ + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" +} - changed
Output schema / properties / data_freshness / properties / policy / descriptionPrevious value: -"Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'"New value: +"Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'" - changed
Output schema / properties / data_freshness / properties / stale_rule_ids / descriptionPrevious value: -"Rules in this response whose verified_at is older than the staleness window stated in `policy`."New value: +"Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count." - added
Output schema / properties / facts / items / properties / last_checked_atAdded value: +{ + "description": "ISO-8601 timestamp of the latest automated check that found this rule's official source text unchanged. Omitted when no such check is recorded. Does not replace verified_at and is not a rule value.", + "format": "date-time", + "type": "string" +} - added
Output schema / properties / sources / items / properties / last_checked_atAdded value: +{ + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" +}
- Changed
check_eligibility7 fields changed- changed
Output schema / allOfPrevious value: -[ - { - "description": "Fields present in every successful tool output.", - "properties": { - "api_version": { - "const": "v1" - }, - "data_freshness": { - "additionalProperties": false, - "properties": { - "generated_at": { - "format": "date-time", - "type": "string" - }, - "newest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "oldest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "policy": { - "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", - "type": "string" - }, - "rules_db_version": { - "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", - "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", - "type": "string" - }, - "stale_rule_ids": { - "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "rules_db_version", - "generated_at", - "oldest_verified_at", - "newest_verified_at", - "stale_rule_ids", - "policy" - ], - "type": "object" - }, - "generated_at": { - "format": "date-time", - "type": "string" - }, - "notice": { - "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", - "description": "Non-affiliation notice included in every response.", - "type": "string" - }, - "sources": { - "items": { - "additionalProperties": false, - "properties": { - "publisher": { - "type": "string" - }, - "supports_rule_ids": { - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "url": { - "format": "uri", - "type": "string" - }, - "verified_at": { - "format": "date", - "type": "string" - } - }, - "required": [ - "url", - "publisher", - "verified_at", - "supports_rule_ids" - ], - "type": "object" - }, - "type": "array" - }, - "tool": { - "type": "string" - }, - "warnings": { - "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "tool", - "api_version", - "notice", - "generated_at", - "sources", - "data_freshness" - ], - "type": "object" - } -]New value: +[ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_last_checked_at": { + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_last_checked_at": { + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "last_checked_at": { + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" + }, + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } +] - added
Output schema / properties / data_freshness / properties / newest_last_checked_atAdded value: +{ + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" +} - added
Output schema / properties / data_freshness / properties / oldest_last_checked_atAdded value: +{ + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" +} - changed
Output schema / properties / data_freshness / properties / policy / descriptionPrevious value: -"Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'"New value: +"Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'" - changed
Output schema / properties / data_freshness / properties / stale_rule_ids / descriptionPrevious value: -"Rules in this response whose verified_at is older than the staleness window stated in `policy`."New value: +"Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count." - added
Output schema / properties / facts / items / properties / last_checked_atAdded value: +{ + "description": "ISO-8601 timestamp of the latest automated check that found this rule's official source text unchanged. Omitted when no such check is recorded. Does not replace verified_at and is not a rule value.", + "format": "date-time", + "type": "string" +} - added
Output schema / properties / sources / items / properties / last_checked_atAdded value: +{ + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" +}
- Changed
get_monetization_requirements7 fields changed- changed
Output schema / allOfPrevious value: -[ - { - "description": "Fields present in every successful tool output.", - "properties": { - "api_version": { - "const": "v1" - }, - "data_freshness": { - "additionalProperties": false, - "properties": { - "generated_at": { - "format": "date-time", - "type": "string" - }, - "newest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "oldest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "policy": { - "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", - "type": "string" - }, - "rules_db_version": { - "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", - "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", - "type": "string" - }, - "stale_rule_ids": { - "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "rules_db_version", - "generated_at", - "oldest_verified_at", - "newest_verified_at", - "stale_rule_ids", - "policy" - ], - "type": "object" - }, - "generated_at": { - "format": "date-time", - "type": "string" - }, - "notice": { - "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", - "description": "Non-affiliation notice included in every response.", - "type": "string" - }, - "sources": { - "items": { - "additionalProperties": false, - "properties": { - "publisher": { - "type": "string" - }, - "supports_rule_ids": { - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "url": { - "format": "uri", - "type": "string" - }, - "verified_at": { - "format": "date", - "type": "string" - } - }, - "required": [ - "url", - "publisher", - "verified_at", - "supports_rule_ids" - ], - "type": "object" - }, - "type": "array" - }, - "tool": { - "type": "string" - }, - "warnings": { - "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "tool", - "api_version", - "notice", - "generated_at", - "sources", - "data_freshness" - ], - "type": "object" - } -]New value: +[ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_last_checked_at": { + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_last_checked_at": { + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "last_checked_at": { + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" + }, + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } +] - added
Output schema / properties / data_freshness / properties / newest_last_checked_atAdded value: +{ + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" +} - added
Output schema / properties / data_freshness / properties / oldest_last_checked_atAdded value: +{ + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" +} - changed
Output schema / properties / data_freshness / properties / policy / descriptionPrevious value: -"Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'"New value: +"Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'" - changed
Output schema / properties / data_freshness / properties / stale_rule_ids / descriptionPrevious value: -"Rules in this response whose verified_at is older than the staleness window stated in `policy`."New value: +"Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count." - added
Output schema / properties / facts / items / properties / last_checked_atAdded value: +{ + "description": "ISO-8601 timestamp of the latest automated check that found this rule's official source text unchanged. Omitted when no such check is recorded. Does not replace verified_at and is not a rule value.", + "format": "date-time", + "type": "string" +} - added
Output schema / properties / sources / items / properties / last_checked_atAdded value: +{ + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" +}
- Changed
get_rule_changes6 fields changed- changed
Output schema / allOfPrevious value: -[ - { - "description": "Fields present in every successful tool output.", - "properties": { - "api_version": { - "const": "v1" - }, - "data_freshness": { - "additionalProperties": false, - "properties": { - "generated_at": { - "format": "date-time", - "type": "string" - }, - "newest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "oldest_verified_at": { - "format": "date", - "type": [ - "string", - "null" - ] - }, - "policy": { - "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", - "type": "string" - }, - "rules_db_version": { - "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", - "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", - "type": "string" - }, - "stale_rule_ids": { - "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "rules_db_version", - "generated_at", - "oldest_verified_at", - "newest_verified_at", - "stale_rule_ids", - "policy" - ], - "type": "object" - }, - "generated_at": { - "format": "date-time", - "type": "string" - }, - "notice": { - "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", - "description": "Non-affiliation notice included in every response.", - "type": "string" - }, - "sources": { - "items": { - "additionalProperties": false, - "properties": { - "publisher": { - "type": "string" - }, - "supports_rule_ids": { - "items": { - "maxLength": 120, - "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", - "type": "string" - }, - "type": "array" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "url": { - "format": "uri", - "type": "string" - }, - "verified_at": { - "format": "date", - "type": "string" - } - }, - "required": [ - "url", - "publisher", - "verified_at", - "supports_rule_ids" - ], - "type": "object" - }, - "type": "array" - }, - "tool": { - "type": "string" - }, - "warnings": { - "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "tool", - "api_version", - "notice", - "generated_at", - "sources", - "data_freshness" - ], - "type": "object" - } -]New value: +[ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_last_checked_at": { + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_last_checked_at": { + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "last_checked_at": { + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" + }, + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } +] - added
Output schema / properties / data_freshness / properties / newest_last_checked_atAdded value: +{ + "description": "Latest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace newest_verified_at.", + "format": "date-time", + "type": "string" +} - added
Output schema / properties / data_freshness / properties / oldest_last_checked_atAdded value: +{ + "description": "Earliest last_checked_at among rules in this response. Omitted when none of those rules have an unchanged-source check. Does not replace oldest_verified_at.", + "format": "date-time", + "type": "string" +} - changed
Output schema / properties / data_freshness / properties / policy / descriptionPrevious value: -"Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'"New value: +"Human-readable freshness policy, e.g. 'Sources are re-checked daily; a rule is listed as stale when the later of verified_at and last_checked_at is more than 7 days before the response date.'" - changed
Output schema / properties / data_freshness / properties / stale_rule_ids / descriptionPrevious value: -"Rules in this response whose verified_at is older than the staleness window stated in `policy`."New value: +"Rules in this response whose later of verified_at and last_checked_at is older than the staleness window stated in `policy`. A missing last_checked_at does not count." - added
Output schema / properties / sources / items / properties / last_checked_atAdded value: +{ + "description": "ISO-8601 timestamp of the latest automated check that found this source's official text unchanged. Omitted when no such check is recorded. Does not replace verified_at.", + "format": "date-time", + "type": "string" +}
1 tool update
- Changed
get_rule_changes2 fields changed- removed
Input schema / properties / since / defaultRemoved value: -"2024-01-01" - changed
Input schema / properties / since / descriptionPrevious value: -"Inclusive lower bound on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at. Omitted on GET, POST, and MCP means 2024-01-01, the same default as the rule-changes page. until defaults to the UTC date of the request. The response echoes both dates at the top level and inside query."New value: +"Inclusive lower bound on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at. Omitted on GET, POST, and MCP means 90 days before the request's UTC date. until defaults to the UTC date of the request. The response echoes both dates at the top level and inside query."
5 tool updates
- Changed
calculate_gap3 fields changed- changed
Input schema / descriptionPrevious value: -"CALCULATION tool. Exact shortfall for each numeric entry requirement of the Monetization Program: absolute amount and percent complete, and which gap is the binding constraint. Ongoing requirements for enrolled creators are reported separately only when already_enrolled=true."New value: +"CALCULATION tool. Exact shortfall for each numeric entry requirement of the Monetization Program: absolute amount and percent complete, and which gap is the binding constraint. Ongoing requirements for enrolled creators are reported separately only when already_enrolled=true. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error." - changed
Input schema / properties / metrics / descriptionPrevious value: -"Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored."New value: +"Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$id": "https://howtomakemoneyonsnapchat.com/schemas/v1/calculate_gap.output.schema.json", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "allOf": [ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } + ], + "properties": { + "already_enrolled": { + "type": "boolean" + }, + "api_version": { + "const": "v1" + }, + "binding_constraint": { + "additionalProperties": false, + "properties": { + "metric": { + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + "percent_complete": { + "type": "number" + }, + "rule": { + "const": "unmet requirement with the lowest percent_complete; ties broken by rule_id" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + } + }, + "required": [ + "rule_id", + "metric", + "percent_complete", + "rule" + ], + "type": [ + "object", + "null" + ] + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "facts": { + "items": { + "additionalProperties": false, + "description": "FACT: a rule record as stored in the versioned rules database (approved records only).", + "properties": { + "applies_to": { + "enum": [ + "entry", + "enrolled_creators", + "all", + "not_applicable" + ], + "type": "string" + }, + "changed_after": { + "description": "Inclusive start of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "changed_before": { + "description": "Inclusive end of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "claim": { + "type": "string" + }, + "date_note": { + "description": "How changed_after and changed_before were established. Null when there is no window note. Not a substitute for source_url.", + "type": [ + "string", + "null" + ] + }, + "effective_date": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "effective_date_note": { + "const": "not published by Snap", + "description": "Present when effective_date is null because Snap did not publish a date. effective_date stays null." + }, + "iso_countries": { + "description": "ISO 3166-1 codes for each name in a country list, from the reviewed country map. Omitted unless this fact is a country list.", + "items": { + "additionalProperties": false, + "properties": { + "alpha2": { + "type": "string" + }, + "alpha3": { + "type": "string" + }, + "numeric": { + "type": "string" + }, + "snap_name": { + "type": "string" + } + }, + "required": [ + "snap_name", + "alpha2", + "alpha3", + "numeric" + ], + "type": "object" + }, + "type": "array" + }, + "label": { + "const": "FACT" + }, + "metric": { + "type": [ + "string", + "null" + ] + }, + "mvp_scope": { + "enum": [ + "in_scope", + "out_of_scope" + ], + "type": "string" + }, + "notes": { + "type": "string" + }, + "operator": { + "enum": [ + "gte", + "gt", + "lte", + "lt", + "eq", + "in", + "is_true", + null + ], + "type": [ + "string", + "null" + ] + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "publisher": { + "type": "string" + }, + "related_rule_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "requirement_phase": { + "enum": [ + "entry", + "ongoing", + "entry_and_ongoing", + "not_applicable" + ], + "type": "string" + }, + "requires_user_confirmation": { + "type": "boolean" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "rule_type": { + "description": "Role of the rule, copied from the rules database. Omitted by older clients. Used to group answer pages.", + "enum": [ + "eligibility_threshold", + "eligibility_condition", + "ongoing_condition", + "payout_term", + "tax_term", + "content_policy", + "program_fact", + "program_status", + "supplementary_note", + null + ], + "type": [ + "string", + "null" + ] + }, + "source_url": { + "format": "uri", + "type": "string" + }, + "status": { + "enum": [ + "current", + "historical", + "unverified" + ], + "type": "string" + }, + "supersedes": { + "type": [ + "string", + "null" + ] + }, + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "verified_at": { + "format": "date", + "type": "string" + }, + "version": { + "minimum": 1, + "type": "integer" + }, + "window_days": { + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "label", + "rule_id", + "version", + "program", + "claim", + "value", + "unit", + "status", + "source_url", + "publisher", + "verified_at", + "effective_date", + "requires_user_confirmation", + "applies_to", + "requirement_phase", + "mvp_scope", + "notes" + ], + "type": "object" + }, + "type": "array" + }, + "gaps": { + "description": "Entry requirements only.", + "items": { + "additionalProperties": false, + "properties": { + "current": { + "type": "number" + }, + "formula": { + "type": "string" + }, + "label": { + "const": "CALCULATION" + }, + "met": { + "type": "boolean" + }, + "metric": { + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + "percent_complete": { + "description": "min(current / threshold, 1) * 100, rounded to 2 dp", + "maximum": 100, + "minimum": 0, + "type": "number" + }, + "percent_complete_uncapped": { + "minimum": 0, + "type": "number" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "rule_version": { + "type": "integer" + }, + "shortfall_absolute": { + "description": "max(threshold - current, 0)", + "minimum": 0, + "type": "number" + }, + "surplus_absolute": { + "description": "max(current - threshold, 0)", + "minimum": 0, + "type": "number" + }, + "threshold": { + "type": "number" + }, + "unit": { + "type": "string" + }, + "window_days": { + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "label", + "rule_id", + "rule_version", + "metric", + "unit", + "threshold", + "current", + "met", + "shortfall_absolute", + "percent_complete", + "percent_complete_uncapped", + "formula" + ], + "type": "object" + }, + "type": "array" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "ongoing_gaps": { + "additionalProperties": false, + "description": "null unless already_enrolled=true.", + "properties": { + "gaps": { + "items": { + "additionalProperties": false, + "properties": { + "current": { + "type": "number" + }, + "formula": { + "type": "string" + }, + "label": { + "const": "CALCULATION" + }, + "met": { + "type": "boolean" + }, + "metric": { + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + "percent_complete": { + "description": "min(current / threshold, 1) * 100, rounded to 2 dp", + "maximum": 100, + "minimum": 0, + "type": "number" + }, + "percent_complete_uncapped": { + "minimum": 0, + "type": "number" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "rule_version": { + "type": "integer" + }, + "shortfall_absolute": { + "description": "max(threshold - current, 0)", + "minimum": 0, + "type": "number" + }, + "surplus_absolute": { + "description": "max(current - threshold, 0)", + "minimum": 0, + "type": "number" + }, + "threshold": { + "type": "number" + }, + "unit": { + "type": "string" + }, + "window_days": { + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "label", + "rule_id", + "rule_version", + "metric", + "unit", + "threshold", + "current", + "met", + "shortfall_absolute", + "percent_complete", + "percent_complete_uncapped", + "formula" + ], + "type": "object" + }, + "type": "array" + }, + "note": { + "const": "Ongoing requirements apply only to creators already enrolled in the Monetization Program. Snap says the 100-hour Spotlight view-time requirement is needed to qualify for maximum Creator Rewards; Snap does not say that rewards stop below it." + } + }, + "required": [ + "note", + "gaps" + ], + "type": [ + "object", + "null" + ] + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "recommendations": { + "items": { + "additionalProperties": false, + "description": "RECOMMENDATION: our suggestion, never a Snap rule. Short and structured; the calling agent writes prose.", + "properties": { + "assumptions": { + "items": { + "type": "string" + }, + "minItems": 1, + "type": "array" + }, + "label": { + "const": "RECOMMENDATION" + }, + "linked_rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "measurable_target": { + "additionalProperties": false, + "properties": { + "by_date": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "metric": { + "description": "Closed vocabulary of creator metrics the engines understand.", + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "meets_age_requirement", + "country", + "is_snap_star", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + "unit": { + "type": "string" + }, + "value": { + "type": "number" + } + }, + "required": [ + "metric", + "value", + "unit" + ], + "type": "object" + }, + "objective": { + "maxLength": 200, + "type": "string" + }, + "order": { + "description": "1 = address first (the binding constraint). An ordering, not a score.", + "minimum": 1, + "type": "integer" + }, + "realism_note": { + "description": "Plain statement when the math is unrealistic, e.g. 'Required pace is 20x your observed pace.'", + "type": [ + "string", + "null" + ] + }, + "reason": { + "maxLength": 300, + "type": "string" + }, + "risks": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "label", + "objective", + "reason", + "linked_rule_id", + "measurable_target", + "assumptions", + "risks" + ], + "type": "object" + }, + "type": "array" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "const": "calculate_gap" + }, + "unknowns": { + "items": { + "additionalProperties": false, + "description": "A requirement we could not evaluate, with the reason and what would resolve it.", + "properties": { + "how_to_resolve": { + "type": "string" + }, + "missing_metric": { + "anyOf": [ + { + "description": "Closed vocabulary of creator metrics the engines understand.", + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "meets_age_requirement", + "country", + "is_snap_star", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + { + "type": "null" + } + ] + }, + "reason": { + "enum": [ + "missing_input", + "rule_unverified", + "requires_user_confirmation", + "not_computable_from_metrics", + "rule_value_not_numeric" + ], + "type": "string" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + } + }, + "required": [ + "rule_id", + "reason", + "how_to_resolve" + ], + "type": "object" + }, + "type": "array" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness", + "program", + "already_enrolled", + "gaps", + "ongoing_gaps", + "binding_constraint", + "unknowns", + "facts", + "recommendations" + ], + "title": "calculate_gap output", + "type": "object" +}
- Changed
calculate_growth_pace3 fields changed- changed
Input schema / descriptionPrevious value: -"CALCULATION tool. Required daily and weekly pace to close each numeric gap within target_days, with a linear scenario plus alternatives and labeled assumptions. A projection, never a prediction."New value: +"CALCULATION tool. Required daily and weekly pace to close each numeric gap within target_days, with a linear scenario plus alternatives and labeled assumptions. A projection, never a prediction. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error." - changed
Input schema / properties / metrics / descriptionPrevious value: -"Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored."New value: +"Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$id": "https://howtomakemoneyonsnapchat.com/schemas/v1/calculate_growth_pace.output.schema.json", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "allOf": [ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } + ], + "properties": { + "already_enrolled": { + "type": "boolean" + }, + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "facts": { + "items": { + "additionalProperties": false, + "description": "FACT: a rule record as stored in the versioned rules database (approved records only).", + "properties": { + "applies_to": { + "enum": [ + "entry", + "enrolled_creators", + "all", + "not_applicable" + ], + "type": "string" + }, + "changed_after": { + "description": "Inclusive start of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "changed_before": { + "description": "Inclusive end of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "claim": { + "type": "string" + }, + "date_note": { + "description": "How changed_after and changed_before were established. Null when there is no window note. Not a substitute for source_url.", + "type": [ + "string", + "null" + ] + }, + "effective_date": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "effective_date_note": { + "const": "not published by Snap", + "description": "Present when effective_date is null because Snap did not publish a date. effective_date stays null." + }, + "iso_countries": { + "description": "ISO 3166-1 codes for each name in a country list, from the reviewed country map. Omitted unless this fact is a country list.", + "items": { + "additionalProperties": false, + "properties": { + "alpha2": { + "type": "string" + }, + "alpha3": { + "type": "string" + }, + "numeric": { + "type": "string" + }, + "snap_name": { + "type": "string" + } + }, + "required": [ + "snap_name", + "alpha2", + "alpha3", + "numeric" + ], + "type": "object" + }, + "type": "array" + }, + "label": { + "const": "FACT" + }, + "metric": { + "type": [ + "string", + "null" + ] + }, + "mvp_scope": { + "enum": [ + "in_scope", + "out_of_scope" + ], + "type": "string" + }, + "notes": { + "type": "string" + }, + "operator": { + "enum": [ + "gte", + "gt", + "lte", + "lt", + "eq", + "in", + "is_true", + null + ], + "type": [ + "string", + "null" + ] + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "publisher": { + "type": "string" + }, + "related_rule_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "requirement_phase": { + "enum": [ + "entry", + "ongoing", + "entry_and_ongoing", + "not_applicable" + ], + "type": "string" + }, + "requires_user_confirmation": { + "type": "boolean" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "rule_type": { + "description": "Role of the rule, copied from the rules database. Omitted by older clients. Used to group answer pages.", + "enum": [ + "eligibility_threshold", + "eligibility_condition", + "ongoing_condition", + "payout_term", + "tax_term", + "content_policy", + "program_fact", + "program_status", + "supplementary_note", + null + ], + "type": [ + "string", + "null" + ] + }, + "source_url": { + "format": "uri", + "type": "string" + }, + "status": { + "enum": [ + "current", + "historical", + "unverified" + ], + "type": "string" + }, + "supersedes": { + "type": [ + "string", + "null" + ] + }, + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "verified_at": { + "format": "date", + "type": "string" + }, + "version": { + "minimum": 1, + "type": "integer" + }, + "window_days": { + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "label", + "rule_id", + "version", + "program", + "claim", + "value", + "unit", + "status", + "source_url", + "publisher", + "verified_at", + "effective_date", + "requires_user_confirmation", + "applies_to", + "requirement_phase", + "mvp_scope", + "notes" + ], + "type": "object" + }, + "type": "array" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "ongoing_paces": { + "additionalProperties": false, + "description": "null unless already_enrolled=true.", + "properties": { + "note": { + "const": "Ongoing requirements apply only to creators already enrolled in the Monetization Program. Snap says the 100-hour Spotlight view-time requirement is needed to qualify for maximum Creator Rewards; Snap does not say that rewards stop below it." + }, + "paces": { + "items": { + "additionalProperties": false, + "properties": { + "already_met": { + "type": "boolean" + }, + "current": { + "type": "number" + }, + "gap": { + "minimum": 0, + "type": "number" + }, + "metric": { + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + "metric_kind": { + "enum": [ + "cumulative", + "rolling_window" + ], + "type": "string" + }, + "observed_daily_change": { + "type": [ + "number", + "null" + ] + }, + "required_to_observed_ratio": { + "description": "linear required_daily / observed_daily_change; null if observed not supplied or <= 0.", + "type": [ + "number", + "null" + ] + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "scenarios": { + "items": { + "additionalProperties": false, + "properties": { + "assumptions": { + "items": { + "type": "string" + }, + "minItems": 1, + "type": "array" + }, + "computable": { + "type": "boolean" + }, + "formula": { + "type": "string" + }, + "label": { + "const": "CALCULATION" + }, + "name": { + "description": "linear: shortfall divided by the caller-chosen days, (T - C) / N. Used for cumulative metrics and for rolling-window metrics. compound: constant daily % growth (cumulative metrics; not computable when current = 0). rolling_window_replacement remains in the enum and is not produced.", + "enum": [ + "linear", + "compound", + "rolling_window_replacement" + ], + "type": "string" + }, + "not_computable_reason": { + "type": [ + "string", + "null" + ] + }, + "required_daily": { + "type": [ + "number", + "null" + ] + }, + "required_daily_growth_rate_pct": { + "description": "compound scenario only", + "type": [ + "number", + "null" + ] + }, + "required_weekly": { + "type": [ + "number", + "null" + ] + }, + "unit": { + "type": "string" + } + }, + "required": [ + "label", + "name", + "computable", + "required_daily", + "required_weekly", + "unit", + "formula", + "assumptions" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" + }, + "threshold": { + "type": "number" + }, + "window_days": { + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "rule_id", + "metric", + "metric_kind", + "current", + "threshold", + "gap", + "scenarios" + ], + "type": "object" + }, + "type": "array" + } + }, + "required": [ + "note", + "paces" + ], + "type": [ + "object", + "null" + ] + }, + "paces": { + "description": "Entry requirements only.", + "items": { + "additionalProperties": false, + "properties": { + "already_met": { + "type": "boolean" + }, + "current": { + "type": "number" + }, + "gap": { + "minimum": 0, + "type": "number" + }, + "metric": { + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + "metric_kind": { + "enum": [ + "cumulative", + "rolling_window" + ], + "type": "string" + }, + "observed_daily_change": { + "type": [ + "number", + "null" + ] + }, + "required_to_observed_ratio": { + "description": "linear required_daily / observed_daily_change; null if observed not supplied or <= 0.", + "type": [ + "number", + "null" + ] + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "scenarios": { + "items": { + "additionalProperties": false, + "properties": { + "assumptions": { + "items": { + "type": "string" + }, + "minItems": 1, + "type": "array" + }, + "computable": { + "type": "boolean" + }, + "formula": { + "type": "string" + }, + "label": { + "const": "CALCULATION" + }, + "name": { + "description": "linear: shortfall divided by the caller-chosen days, (T - C) / N. Used for cumulative metrics and for rolling-window metrics. compound: constant daily % growth (cumulative metrics; not computable when current = 0). rolling_window_replacement remains in the enum and is not produced.", + "enum": [ + "linear", + "compound", + "rolling_window_replacement" + ], + "type": "string" + }, + "not_computable_reason": { + "type": [ + "string", + "null" + ] + }, + "required_daily": { + "type": [ + "number", + "null" + ] + }, + "required_daily_growth_rate_pct": { + "description": "compound scenario only", + "type": [ + "number", + "null" + ] + }, + "required_weekly": { + "type": [ + "number", + "null" + ] + }, + "unit": { + "type": "string" + } + }, + "required": [ + "label", + "name", + "computable", + "required_daily", + "required_weekly", + "unit", + "formula", + "assumptions" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" + }, + "threshold": { + "type": "number" + }, + "window_days": { + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "rule_id", + "metric", + "metric_kind", + "current", + "threshold", + "gap", + "scenarios" + ], + "type": "object" + }, + "type": "array" + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "projection_disclaimer": { + "const": "Projections show the pace required under stated assumptions. They are not predictions of what will happen." + }, + "recommendations": { + "items": { + "additionalProperties": false, + "description": "RECOMMENDATION: our suggestion, never a Snap rule. Short and structured; the calling agent writes prose.", + "properties": { + "assumptions": { + "items": { + "type": "string" + }, + "minItems": 1, + "type": "array" + }, + "label": { + "const": "RECOMMENDATION" + }, + "linked_rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "measurable_target": { + "additionalProperties": false, + "properties": { + "by_date": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "metric": { + "description": "Closed vocabulary of creator metrics the engines understand.", + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "meets_age_requirement", + "country", + "is_snap_star", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + "unit": { + "type": "string" + }, + "value": { + "type": "number" + } + }, + "required": [ + "metric", + "value", + "unit" + ], + "type": "object" + }, + "objective": { + "maxLength": 200, + "type": "string" + }, + "order": { + "description": "1 = address first (the binding constraint). An ordering, not a score.", + "minimum": 1, + "type": "integer" + }, + "realism_note": { + "description": "Plain statement when the math is unrealistic, e.g. 'Required pace is 20x your observed pace.'", + "type": [ + "string", + "null" + ] + }, + "reason": { + "maxLength": 300, + "type": "string" + }, + "risks": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "label", + "objective", + "reason", + "linked_rule_id", + "measurable_target", + "assumptions", + "risks" + ], + "type": "object" + }, + "type": "array" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "target_date": { + "format": "date", + "type": "string" + }, + "target_days": { + "type": "integer" + }, + "tool": { + "const": "calculate_growth_pace" + }, + "unknowns": { + "items": { + "additionalProperties": false, + "description": "A requirement we could not evaluate, with the reason and what would resolve it.", + "properties": { + "how_to_resolve": { + "type": "string" + }, + "missing_metric": { + "anyOf": [ + { + "description": "Closed vocabulary of creator metrics the engines understand.", + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "meets_age_requirement", + "country", + "is_snap_star", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + { + "type": "null" + } + ] + }, + "reason": { + "enum": [ + "missing_input", + "rule_unverified", + "requires_user_confirmation", + "not_computable_from_metrics", + "rule_value_not_numeric" + ], + "type": "string" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + } + }, + "required": [ + "rule_id", + "reason", + "how_to_resolve" + ], + "type": "object" + }, + "type": "array" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness", + "program", + "already_enrolled", + "target_days", + "target_date", + "paces", + "ongoing_paces", + "projection_disclaimer", + "unknowns", + "facts", + "recommendations" + ], + "title": "calculate_growth_pace output", + "type": "object" +}
- Changed
check_eligibility3 fields changed- changed
Input schema / descriptionPrevious value: -"CALCULATION tool. Creator metrics in; pass/fail per published entry requirement of the Monetization Program out, plus unknowns and requirements needing the creator's own confirmation. Never returns an 'eligible' verdict: the result is meets_published_criteria / does_not_meet_published_criteria / unknown, with a fixed disclaimer that invitation is at Snap's discretion. Ongoing requirements for enrolled creators are reported separately only when already_enrolled=true."New value: +"CALCULATION tool. Creator metrics in; pass/fail per published entry requirement of the Monetization Program out, plus unknowns and requirements needing the creator's own confirmation. Never returns an 'eligible' verdict: the result is meets_published_criteria / does_not_meet_published_criteria / unknown, with a fixed disclaimer that invitation is at Snap's discretion. Ongoing requirements for enrolled creators are reported separately only when already_enrolled=true. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error." - changed
Input schema / properties / metrics / descriptionPrevious value: -"Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored."New value: +"Metrics supplied by the caller (the creator or their agent). We never look metrics up ourselves; Snap offers no public analytics for arbitrary usernames. All fields optional; missing fields produce `unknowns`, never guesses. Data minimization: no age, birthdate, name, or username is accepted; creator age is never stored. Caller metrics are checked for plausibility. spotlight_view_time_hours_28d above view_time_hours_28d returns VALUE_INCONSISTENT. view_time_hours_28d above 28 days × 24 hours × followers × 0.5 is a warning that the figure is unusually high for your follower count, please check for a typo. The warning also says view time can come from non-followers. followers of 0 with hours above 0 is the same kind of warning, never an error." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$id": "https://howtomakemoneyonsnapchat.com/schemas/v1/check_eligibility.output.schema.json", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "allOf": [ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } + ], + "properties": { + "already_enrolled": { + "type": "boolean" + }, + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "facts": { + "items": { + "additionalProperties": false, + "description": "FACT: a rule record as stored in the versioned rules database (approved records only).", + "properties": { + "applies_to": { + "enum": [ + "entry", + "enrolled_creators", + "all", + "not_applicable" + ], + "type": "string" + }, + "changed_after": { + "description": "Inclusive start of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "changed_before": { + "description": "Inclusive end of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "claim": { + "type": "string" + }, + "date_note": { + "description": "How changed_after and changed_before were established. Null when there is no window note. Not a substitute for source_url.", + "type": [ + "string", + "null" + ] + }, + "effective_date": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "effective_date_note": { + "const": "not published by Snap", + "description": "Present when effective_date is null because Snap did not publish a date. effective_date stays null." + }, + "iso_countries": { + "description": "ISO 3166-1 codes for each name in a country list, from the reviewed country map. Omitted unless this fact is a country list.", + "items": { + "additionalProperties": false, + "properties": { + "alpha2": { + "type": "string" + }, + "alpha3": { + "type": "string" + }, + "numeric": { + "type": "string" + }, + "snap_name": { + "type": "string" + } + }, + "required": [ + "snap_name", + "alpha2", + "alpha3", + "numeric" + ], + "type": "object" + }, + "type": "array" + }, + "label": { + "const": "FACT" + }, + "metric": { + "type": [ + "string", + "null" + ] + }, + "mvp_scope": { + "enum": [ + "in_scope", + "out_of_scope" + ], + "type": "string" + }, + "notes": { + "type": "string" + }, + "operator": { + "enum": [ + "gte", + "gt", + "lte", + "lt", + "eq", + "in", + "is_true", + null + ], + "type": [ + "string", + "null" + ] + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "publisher": { + "type": "string" + }, + "related_rule_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "requirement_phase": { + "enum": [ + "entry", + "ongoing", + "entry_and_ongoing", + "not_applicable" + ], + "type": "string" + }, + "requires_user_confirmation": { + "type": "boolean" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "rule_type": { + "description": "Role of the rule, copied from the rules database. Omitted by older clients. Used to group answer pages.", + "enum": [ + "eligibility_threshold", + "eligibility_condition", + "ongoing_condition", + "payout_term", + "tax_term", + "content_policy", + "program_fact", + "program_status", + "supplementary_note", + null + ], + "type": [ + "string", + "null" + ] + }, + "source_url": { + "format": "uri", + "type": "string" + }, + "status": { + "enum": [ + "current", + "historical", + "unverified" + ], + "type": "string" + }, + "supersedes": { + "type": [ + "string", + "null" + ] + }, + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "verified_at": { + "format": "date", + "type": "string" + }, + "version": { + "minimum": 1, + "type": "integer" + }, + "window_days": { + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "label", + "rule_id", + "version", + "program", + "claim", + "value", + "unit", + "status", + "source_url", + "publisher", + "verified_at", + "effective_date", + "requires_user_confirmation", + "applies_to", + "requirement_phase", + "mvp_scope", + "notes" + ], + "type": "object" + }, + "type": "array" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "ongoing_requirements": { + "additionalProperties": false, + "description": "null unless already_enrolled=true.", + "properties": { + "note": { + "const": "Ongoing requirements apply only to creators already enrolled in the Monetization Program. Snap says the 100-hour Spotlight view-time requirement is needed to qualify for maximum Creator Rewards; Snap does not say that rewards stop below it." + }, + "requirements": { + "items": { + "additionalProperties": false, + "properties": { + "claim": { + "type": "string" + }, + "explanation": { + "maxLength": 300, + "type": "string" + }, + "input_value": { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + "label": { + "const": "CALCULATION" + }, + "metric": { + "anyOf": [ + { + "description": "Closed vocabulary of creator metrics the engines understand.", + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "meets_age_requirement", + "country", + "is_snap_star", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + { + "type": "null" + } + ] + }, + "operator": { + "enum": [ + "gte", + "gt", + "lte", + "lt", + "eq", + "in", + "is_true", + null + ], + "type": [ + "string", + "null" + ] + }, + "outcome": { + "enum": [ + "pass", + "fail", + "unknown", + "requires_user_confirmation", + "user_confirmed", + "user_denied" + ], + "type": "string" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "rule_status": { + "enum": [ + "current", + "unverified" + ], + "type": "string" + }, + "rule_version": { + "type": "integer" + }, + "threshold": { + "additionalProperties": false, + "properties": { + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + } + }, + "required": [ + "value", + "unit" + ], + "type": "object" + } + }, + "required": [ + "label", + "rule_id", + "rule_version", + "claim", + "rule_status", + "outcome", + "threshold", + "input_value" + ], + "type": "object" + }, + "type": "array" + } + }, + "required": [ + "note", + "requirements" + ], + "type": [ + "object", + "null" + ] + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "requirements": { + "items": { + "additionalProperties": false, + "properties": { + "claim": { + "type": "string" + }, + "explanation": { + "maxLength": 300, + "type": "string" + }, + "input_value": { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + "label": { + "const": "CALCULATION" + }, + "metric": { + "anyOf": [ + { + "description": "Closed vocabulary of creator metrics the engines understand.", + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "meets_age_requirement", + "country", + "is_snap_star", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + { + "type": "null" + } + ] + }, + "operator": { + "enum": [ + "gte", + "gt", + "lte", + "lt", + "eq", + "in", + "is_true", + null + ], + "type": [ + "string", + "null" + ] + }, + "outcome": { + "enum": [ + "pass", + "fail", + "unknown", + "requires_user_confirmation", + "user_confirmed", + "user_denied" + ], + "type": "string" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "rule_status": { + "enum": [ + "current", + "unverified" + ], + "type": "string" + }, + "rule_version": { + "type": "integer" + }, + "threshold": { + "additionalProperties": false, + "properties": { + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + } + }, + "required": [ + "value", + "unit" + ], + "type": "object" + } + }, + "required": [ + "label", + "rule_id", + "rule_version", + "claim", + "rule_status", + "outcome", + "threshold", + "input_value" + ], + "type": "object" + }, + "type": "array" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "summary": { + "additionalProperties": false, + "allOf": [ + { + "if": { + "properties": { + "published_criteria_status": { + "const": "meets_published_criteria" + } + } + }, + "then": { + "properties": { + "disclaimer": { + "const": "Meets the published criteria; invitation to the Monetization Program is at Snap's discretion." + } + } + } + }, + { + "if": { + "properties": { + "published_criteria_status": { + "const": "does_not_meet_published_criteria" + } + } + }, + "then": { + "properties": { + "disclaimer": { + "const": "Does not meet the published criteria based on the inputs provided; invitation to the Monetization Program is at Snap's discretion." + } + } + } + }, + { + "if": { + "properties": { + "published_criteria_status": { + "const": "unknown" + } + } + }, + "then": { + "properties": { + "disclaimer": { + "const": "Cannot determine whether the published criteria are met from the inputs provided (some requirements are unknown or need the creator's confirmation); invitation to the Monetization Program is at Snap's discretion." + } + } + } + } + ], + "description": "Entry requirements only. published_criteria_status rule: does_not_meet_published_criteria if any requirement is fail or user_denied; otherwise unknown if any is unknown or requires_user_confirmation; otherwise meets_published_criteria. There is deliberately no 'eligible' verdict.", + "properties": { + "disclaimer": { + "enum": [ + "Meets the published criteria; invitation to the Monetization Program is at Snap's discretion.", + "Does not meet the published criteria based on the inputs provided; invitation to the Monetization Program is at Snap's discretion.", + "Cannot determine whether the published criteria are met from the inputs provided (some requirements are unknown or need the creator's confirmation); invitation to the Monetization Program is at Snap's discretion." + ], + "type": "string" + }, + "fail_count": { + "minimum": 0, + "type": "integer" + }, + "pass_count": { + "minimum": 0, + "type": "integer" + }, + "published_criteria_status": { + "enum": [ + "meets_published_criteria", + "does_not_meet_published_criteria", + "unknown" + ], + "type": "string" + }, + "requires_confirmation_count": { + "minimum": 0, + "type": "integer" + }, + "unknown_count": { + "minimum": 0, + "type": "integer" + } + }, + "required": [ + "published_criteria_status", + "disclaimer", + "pass_count", + "fail_count", + "unknown_count", + "requires_confirmation_count" + ], + "type": "object" + }, + "tool": { + "const": "check_eligibility" + }, + "unknowns": { + "items": { + "additionalProperties": false, + "description": "A requirement we could not evaluate, with the reason and what would resolve it.", + "properties": { + "how_to_resolve": { + "type": "string" + }, + "missing_metric": { + "anyOf": [ + { + "description": "Closed vocabulary of creator metrics the engines understand.", + "enum": [ + "followers", + "view_time_hours_28d", + "spotlight_view_time_hours_28d", + "meets_age_requirement", + "country", + "is_snap_star", + "posts_per_month", + "active_posting_days_28d" + ], + "type": "string" + }, + { + "type": "null" + } + ] + }, + "reason": { + "enum": [ + "missing_input", + "rule_unverified", + "requires_user_confirmation", + "not_computable_from_metrics", + "rule_value_not_numeric" + ], + "type": "string" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + } + }, + "required": [ + "rule_id", + "reason", + "how_to_resolve" + ], + "type": "object" + }, + "type": "array" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness", + "program", + "already_enrolled", + "summary", + "requirements", + "ongoing_requirements", + "unknowns", + "facts" + ], + "title": "check_eligibility output", + "type": "object" +}
- Changed
get_monetization_requirements1 field changed- changed
Output schema / (root)Previous value: -nullNew value: +{ + "$id": "https://howtomakemoneyonsnapchat.com/schemas/v1/get_monetization_requirements.output.schema.json", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "allOf": [ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } + ], + "properties": { + "api_version": { + "const": "v1" + }, + "catalog_scope": { + "additionalProperties": false, + "description": "Counts computed from the approved rules database for one as-of date. mvp_in_force is the default requirements list. in_force_including_out_of_scope adds programs stored as out of scope. mvp_including_historical is every in-scope record, which is what the rule-change log lists.", + "properties": { + "approved_total": { + "minimum": 0, + "type": "integer" + }, + "in_force_including_out_of_scope": { + "minimum": 0, + "type": "integer" + }, + "mvp_in_force": { + "minimum": 0, + "type": "integer" + }, + "mvp_including_historical": { + "minimum": 0, + "type": "integer" + }, + "out_of_scope_programs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "summary": { + "type": "string" + } + }, + "required": [ + "mvp_in_force", + "in_force_including_out_of_scope", + "mvp_including_historical", + "approved_total", + "out_of_scope_programs", + "summary" + ], + "type": "object" + }, + "country_eligibility": { + "items": { + "additionalProperties": false, + "properties": { + "country": { + "type": "string" + }, + "listed": { + "type": [ + "boolean", + "null" + ] + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + } + }, + "required": [ + "program", + "country", + "listed", + "rule_id" + ], + "type": "object" + }, + "type": [ + "array", + "null" + ] + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "direct_answer": { + "description": "Answer-first lead built from entry-requirement facts included in this response. Omitted when those facts are absent.", + "type": "string" + }, + "direct_answer_note": { + "description": "Optional sentence after the lead for unverified entry facts left out of it. Omitted when there are none.", + "type": "string" + }, + "facts": { + "items": { + "additionalProperties": false, + "description": "FACT: a rule record as stored in the versioned rules database (approved records only).", + "properties": { + "applies_to": { + "enum": [ + "entry", + "enrolled_creators", + "all", + "not_applicable" + ], + "type": "string" + }, + "changed_after": { + "description": "Inclusive start of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "changed_before": { + "description": "Inclusive end of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "claim": { + "type": "string" + }, + "date_note": { + "description": "How changed_after and changed_before were established. Null when there is no window note. Not a substitute for source_url.", + "type": [ + "string", + "null" + ] + }, + "effective_date": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "effective_date_note": { + "const": "not published by Snap", + "description": "Present when effective_date is null because Snap did not publish a date. effective_date stays null." + }, + "iso_countries": { + "description": "ISO 3166-1 codes for each name in a country list, from the reviewed country map. Omitted unless this fact is a country list.", + "items": { + "additionalProperties": false, + "properties": { + "alpha2": { + "type": "string" + }, + "alpha3": { + "type": "string" + }, + "numeric": { + "type": "string" + }, + "snap_name": { + "type": "string" + } + }, + "required": [ + "snap_name", + "alpha2", + "alpha3", + "numeric" + ], + "type": "object" + }, + "type": "array" + }, + "label": { + "const": "FACT" + }, + "metric": { + "type": [ + "string", + "null" + ] + }, + "mvp_scope": { + "enum": [ + "in_scope", + "out_of_scope" + ], + "type": "string" + }, + "notes": { + "type": "string" + }, + "operator": { + "enum": [ + "gte", + "gt", + "lte", + "lt", + "eq", + "in", + "is_true", + null + ], + "type": [ + "string", + "null" + ] + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "publisher": { + "type": "string" + }, + "related_rule_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "requirement_phase": { + "enum": [ + "entry", + "ongoing", + "entry_and_ongoing", + "not_applicable" + ], + "type": "string" + }, + "requires_user_confirmation": { + "type": "boolean" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "rule_type": { + "description": "Role of the rule, copied from the rules database. Omitted by older clients. Used to group answer pages.", + "enum": [ + "eligibility_threshold", + "eligibility_condition", + "ongoing_condition", + "payout_term", + "tax_term", + "content_policy", + "program_fact", + "program_status", + "supplementary_note", + null + ], + "type": [ + "string", + "null" + ] + }, + "source_url": { + "format": "uri", + "type": "string" + }, + "status": { + "enum": [ + "current", + "historical", + "unverified" + ], + "type": "string" + }, + "supersedes": { + "type": [ + "string", + "null" + ] + }, + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "verified_at": { + "format": "date", + "type": "string" + }, + "version": { + "minimum": 1, + "type": "integer" + }, + "window_days": { + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "label", + "rule_id", + "version", + "program", + "claim", + "value", + "unit", + "status", + "source_url", + "publisher", + "verified_at", + "effective_date", + "requires_user_confirmation", + "applies_to", + "requirement_phase", + "mvp_scope", + "notes" + ], + "type": "object" + }, + "type": "array" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "programs": { + "items": { + "additionalProperties": false, + "properties": { + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "program_status": { + "enum": [ + "active", + "historical", + "unknown" + ], + "type": "string" + }, + "rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "program", + "program_status", + "rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "query": { + "additionalProperties": true, + "description": "Echo of the effective filters.", + "type": "object" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "const": "get_monetization_requirements" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness", + "programs", + "facts" + ], + "title": "get_monetization_requirements output", + "type": "object" +}
- Changed
get_rule_changes1 field changed- changed
Output schema / (root)Previous value: -nullNew value: +{ + "$id": "https://howtomakemoneyonsnapchat.com/schemas/v1/get_rule_changes.output.schema.json", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "allOf": [ + { + "description": "Fields present in every successful tool output.", + "properties": { + "api_version": { + "const": "v1" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness" + ], + "type": "object" + } + ], + "properties": { + "api_version": { + "const": "v1" + }, + "baseline": { + "description": "Initial-load records. Present only when include_baseline is true. Never included in changes or in change counts.", + "items": { + "additionalProperties": false, + "properties": { + "change_type": { + "const": "baseline" + }, + "changed_after": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "changed_before": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "current": { + "additionalProperties": false, + "properties": { + "claim": { + "type": "string" + }, + "status": { + "enum": [ + "current", + "historical", + "unverified" + ], + "type": "string" + }, + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "verified_at": { + "format": "date", + "type": "string" + }, + "version": { + "type": "integer" + } + }, + "required": [ + "version", + "value", + "unit", + "status", + "verified_at" + ], + "type": [ + "object", + "null" + ] + }, + "date_confidence": { + "description": "stated_by_snap, bounded_by_archives, or unknown. Null on records that predate the field.", + "enum": [ + "stated_by_snap", + "bounded_by_archives", + "unknown", + null + ], + "type": [ + "string", + "null" + ] + }, + "date_display": { + "description": "Rendered public date line: Snap's date, an archive window with evidence URLs, or unknown, plus the day first recorded by us.", + "type": "string" + }, + "date_note": { + "type": [ + "string", + "null" + ] + }, + "detected_at": { + "format": "date", + "type": "string" + }, + "effective_date": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "effective_date_note": { + "const": "not published by Snap", + "description": "Present when effective_date is null because Snap did not publish a date. effective_date stays null." + }, + "effective_month": { + "pattern": "^[0-9]{4}-[0-9]{2}$", + "type": [ + "string", + "null" + ] + }, + "evidence_urls": { + "description": "Wayback captures or Snap URLs that support the date. Empty when there are none.", + "items": { + "format": "uri", + "type": "string" + }, + "type": "array" + }, + "first_recorded_by_us": { + "description": "Day this project first recorded the change. Null when the record has no such date. Not Snap's date.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "label": { + "const": "FACT" + }, + "notes": { + "type": "string" + }, + "previous": { + "additionalProperties": false, + "properties": { + "claim": { + "type": "string" + }, + "status": { + "enum": [ + "current", + "historical", + "unverified" + ], + "type": "string" + }, + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "verified_at": { + "format": "date", + "type": "string" + }, + "version": { + "type": "integer" + } + }, + "required": [ + "version", + "value", + "unit", + "status", + "verified_at" + ], + "type": [ + "object", + "null" + ] + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "snap_announced_date": { + "description": "Day Snap announced the rule. Null when Snap did not state an announcement day.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "snap_effective_date": { + "description": "Day Snap stated the rule took effect. Null when Snap did not state one.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "source_url": { + "format": "uri", + "type": "string" + } + }, + "required": [ + "label", + "rule_id", + "program", + "change_type", + "previous", + "current", + "source_url", + "detected_at", + "effective_date" + ], + "type": "object" + }, + "type": "array" + }, + "catalog_scope": { + "additionalProperties": false, + "description": "Counts computed from the approved rules database for one as-of date. mvp_in_force is the default requirements list. in_force_including_out_of_scope adds programs stored as out of scope. mvp_including_historical is every in-scope record, which is what the rule-change log lists.", + "properties": { + "approved_total": { + "minimum": 0, + "type": "integer" + }, + "in_force_including_out_of_scope": { + "minimum": 0, + "type": "integer" + }, + "mvp_in_force": { + "minimum": 0, + "type": "integer" + }, + "mvp_including_historical": { + "minimum": 0, + "type": "integer" + }, + "out_of_scope_programs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "summary": { + "type": "string" + } + }, + "required": [ + "mvp_in_force", + "in_force_including_out_of_scope", + "mvp_including_historical", + "approved_total", + "out_of_scope_programs", + "summary" + ], + "type": "object" + }, + "changes": { + "items": { + "additionalProperties": false, + "properties": { + "change_type": { + "description": "How this record differs from the approved record it supersedes, or the type on an explicit change block. Baseline records are returned only in baseline.", + "enum": [ + "added", + "value_changed", + "status_changed", + "retired", + "source_changed", + "baseline" + ], + "type": "string" + }, + "changed_after": { + "description": "Inclusive start of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "changed_before": { + "description": "Inclusive end of an observed change window when the source does not state a single effective_date. Null when unknown. Additive.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "current": { + "additionalProperties": false, + "properties": { + "claim": { + "type": "string" + }, + "status": { + "enum": [ + "current", + "historical", + "unverified" + ], + "type": "string" + }, + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "verified_at": { + "format": "date", + "type": "string" + }, + "version": { + "type": "integer" + } + }, + "required": [ + "version", + "value", + "unit", + "status", + "verified_at" + ], + "type": [ + "object", + "null" + ] + }, + "date_confidence": { + "description": "stated_by_snap, bounded_by_archives, or unknown. Null on records that predate the field.", + "enum": [ + "stated_by_snap", + "bounded_by_archives", + "unknown", + null + ], + "type": [ + "string", + "null" + ] + }, + "date_display": { + "description": "Rendered public date line: Snap's date, an archive window with evidence URLs, or unknown, plus the day first recorded by us.", + "type": "string" + }, + "date_note": { + "description": "How changed_after and changed_before were established. Null when there is no window note. Not a substitute for source_url.", + "type": [ + "string", + "null" + ] + }, + "detected_at": { + "format": "date", + "type": "string" + }, + "effective_date": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "effective_date_note": { + "const": "not published by Snap", + "description": "Present when effective_date is null because Snap did not publish a date. effective_date stays null." + }, + "effective_month": { + "description": "Month-only announcement when Snap did not publish a day, YYYY-MM. Null when the change has a day or no month.", + "pattern": "^[0-9]{4}-[0-9]{2}$", + "type": [ + "string", + "null" + ] + }, + "evidence_urls": { + "description": "Wayback captures or Snap URLs that support the date. Empty when there are none.", + "items": { + "format": "uri", + "type": "string" + }, + "type": "array" + }, + "first_recorded_by_us": { + "description": "Day this project first recorded the change. Null when the record has no such date. Not Snap's date.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "label": { + "const": "FACT" + }, + "notes": { + "type": "string" + }, + "previous": { + "additionalProperties": false, + "properties": { + "claim": { + "type": "string" + }, + "status": { + "enum": [ + "current", + "historical", + "unverified" + ], + "type": "string" + }, + "unit": { + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": [ + "number", + "string", + "boolean", + "null" + ] + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "verified_at": { + "format": "date", + "type": "string" + }, + "version": { + "type": "integer" + } + }, + "required": [ + "version", + "value", + "unit", + "status", + "verified_at" + ], + "type": [ + "object", + "null" + ] + }, + "program": { + "description": "Program identifier. Validated at runtime against programs present in the rules database; unknown values return UNKNOWN_PROGRAM. Examples: unified_monetization_program, snap_star, creator_subscriptions, brand_partnerships, payouts, tax, recommendation_eligibility, creator_monetization_policy, public_profile, lens_creator_rewards.", + "pattern": "^[a-z0-9_]{2,64}$", + "type": "string" + }, + "rule_id": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "snap_announced_date": { + "description": "Day Snap announced the rule. Null when Snap did not state an announcement day.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "snap_effective_date": { + "description": "Day Snap stated the rule took effect. Null when Snap did not state one.", + "format": "date", + "type": [ + "string", + "null" + ] + }, + "source_url": { + "format": "uri", + "type": "string" + } + }, + "required": [ + "label", + "rule_id", + "program", + "change_type", + "previous", + "current", + "source_url", + "detected_at", + "effective_date" + ], + "type": "object" + }, + "type": "array" + }, + "data_freshness": { + "additionalProperties": false, + "properties": { + "generated_at": { + "format": "date-time", + "type": "string" + }, + "newest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "oldest_verified_at": { + "format": "date", + "type": [ + "string", + "null" + ] + }, + "policy": { + "description": "Human-readable freshness policy, e.g. 'Sources are re-checked daily; rules not re-verified within 7 days are listed as stale.'", + "type": "string" + }, + "rules_db_version": { + "description": "Monotonic version of the published rules set. Pattern YYYY-MM-DD.n", + "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}\\.[0-9]+$", + "type": "string" + }, + "stale_rule_ids": { + "description": "Rules in this response whose verified_at is older than the staleness window stated in `policy`.", + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "rules_db_version", + "generated_at", + "oldest_verified_at", + "newest_verified_at", + "stale_rule_ids", + "policy" + ], + "type": "object" + }, + "generated_at": { + "format": "date-time", + "type": "string" + }, + "next_cursor": { + "type": [ + "string", + "null" + ] + }, + "notice": { + "const": "HowToMakeMoneyOnSnapchat.com is an independent third party and is not affiliated with, endorsed by, or sponsored by Snap Inc. Snapchat is a trademark of Snap Inc.", + "description": "Non-affiliation notice included in every response.", + "type": "string" + }, + "query": { + "additionalProperties": false, + "description": "Filters applied to this response, including defaults. Top-level since and until stay for older clients.", + "properties": { + "cursor": { + "type": [ + "string", + "null" + ] + }, + "include_baseline": { + "type": "boolean" + }, + "limit": { + "type": "integer" + }, + "program": { + "type": [ + "string", + "null" + ] + }, + "since": { + "format": "date", + "type": "string" + }, + "until": { + "format": "date", + "type": "string" + } + }, + "required": [ + "since", + "until", + "program", + "limit", + "include_baseline", + "cursor" + ], + "type": "object" + }, + "since": { + "format": "date", + "type": "string" + }, + "sources": { + "items": { + "additionalProperties": false, + "properties": { + "publisher": { + "type": "string" + }, + "supports_rule_ids": { + "items": { + "maxLength": 120, + "pattern": "^[a-z0-9_]+(\\.[a-z0-9_]+)+$", + "type": "string" + }, + "type": "array" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "url": { + "format": "uri", + "type": "string" + }, + "verified_at": { + "format": "date", + "type": "string" + } + }, + "required": [ + "url", + "publisher", + "verified_at", + "supports_rule_ids" + ], + "type": "object" + }, + "type": "array" + }, + "tool": { + "const": "get_rule_changes" + }, + "until": { + "format": "date", + "type": "string" + }, + "warnings": { + "description": "Plain strings. Omitted when empty. Calculation tools add a string when followers is 0 and view_time_hours_28d or spotlight_view_time_hours_28d is above 0, and when view_time_hours_28d exceeds 28 days × 24 hours × followers × 0.5. Those warnings say the figure is unusually high for your follower count, please check for a typo, and that view time can come from non-followers. They are never an error. FACT GET aliases append ignored query parameter notices to this same array. Spotlight hours above total view hours are HTTP 400 VALUE_INCONSISTENT rather than a warning.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "tool", + "api_version", + "notice", + "generated_at", + "sources", + "data_freshness", + "since", + "until", + "query", + "changes", + "next_cursor" + ], + "title": "get_rule_changes output", + "type": "object" +}
1 tool update
- Changed
get_rule_changes1 field changed- changed
Input schema / properties / since / descriptionPrevious value: -"Inclusive lower bound on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at. Omitted on GET, POST, and MCP means 2024-01-01, the same default as the rule-changes page. The response echoes the date used."New value: +"Inclusive lower bound on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at. Omitted on GET, POST, and MCP means 2024-01-01, the same default as the rule-changes page. until defaults to the UTC date of the request. The response echoes both dates at the top level and inside query."
1 tool update
- Changed
get_rule_changes3 fields changed- added
Input schema / properties / since / defaultAdded value: +"2024-01-01" - changed
Input schema / properties / since / descriptionPrevious value: -"Inclusive lower bound on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at."New value: +"Inclusive lower bound on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at. Omitted on GET, POST, and MCP means 2024-01-01, the same default as the rule-changes page. The response echoes the date used." - removed
Input schema / requiredRemoved value: -[ - "since" -]
1 tool update
- Changed
get_monetization_requirements1 field changed- changed
Input schema / properties / country / descriptionPrevious value: -"Optional country filter for the country lookup. Accepts ISO 3166-1 alpha-2, alpha-3, or the English name."New value: +"ISO 3166-1 alpha-2, alpha-3, or an English country name. Adds country_eligibility. Does not remove facts."
1 tool update
- Changed
get_rule_changes4 fields changed- changed
Input schema / descriptionPrevious value: -"FACT tool. Lists changes to Snap monetization rules detected since a date: previous value, new value, source, detected date. Only changes approved for publication are returned."New value: +"FACT tool. Lists approved changes to Snap monetization rules. A change is a record that supersedes an approved earlier record and differs in value, status, or source, or a record with an explicit approved change block (added or retired). Baseline records (no supersedes and no change block) are omitted unless include_baseline is true, and they are never included in changes or in change counts. since and until filter on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at. They do not filter on verified_at." - added
Input schema / properties / include_baselineAdded value: +{ + "default": false, + "description": "When true, also return baseline records in baseline. Baseline records are never included in changes.", + "type": "boolean" +} - added
Input schema / properties / since / descriptionAdded value: +"Inclusive lower bound on the change date: effective_date, else changed_before, else the last day of effective_month, else detected_at." - added
Input schema / properties / until / descriptionAdded value: +"Inclusive upper bound on that same change date. Default: the UTC date of the request."
5 tool updates
- First observed
calculate_gap - First observed
calculate_growth_pace - First observed
check_eligibility - First observed
get_monetization_requirements - First observed
get_rule_changes
Related MCP Connectors
294 public-data tools across 60 domains; source freshness varies. Free tier.
13 tools: OFAC sanctions, counterparty checks, company, domain, email. 25 free calls.
API Tool Calls: Home cost planners, proofreading, QR and barcodes, page to Markdown, SEO checks and recalls. Free agent tools: 20 calls/day per IP, no key.
49 free agent tools: WHOIS, PDF to text, email checks, FX rates, X12 EDI, JSON repair. No API key.
Related MCP Servers
- AlicenseDqualityCmaintenanceProvides 27 tools for web search, content extraction, and data processing without requiring any API keys.274MIT
- AlicenseAqualityAmaintenance14 tools for AI agents: transcript extraction in five formats with adjustable segment size, video metadata, video and channel search, channel browsing, in-channel search, playlists, and an asynchronous batch job for up to 4,000 transcripts. Free tier: 100 credits on signup, no card.614MIT
studiomeyer-geoofficial
AlicenseNot gradedqualityBmaintenanceAI visibility monitoring. 23 tools for 8 LLM platforms. 19 tools free without API keys.3MIT
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd
Glama MCP Gateway
Add one secure layer between your agents and this server.