A
licenseB
qualityB
maintenanceRead-only MCP server for Meta Ads that lists and reads ad accounts, campaigns, ad sets, ads, ad images, creatives, and fetches insights at various levels.
14
MIT
How To Make Money On Snapchat
Server Details
Read-only published criteria. Not affiliated with, endorsed by, or sponsored by Snap Inc.
Ownership verified
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
A4.4/5.0
Scored across 5 tools
Disambiguation5/5
Each tool's description explicitly states its purpose and cross-references the sibling tools it should not be confused with (e.g. calculate_gap vs calculate_growth_pace vs check_eligibility). The boundaries between the three metric-based tools are clearly drawn by output type: shortfall, pace, or pass/fail.
Naming Consistency5/5
All five tools follow a clean verb_noun snake_case pattern: calculate_gap, calculate_growth_pace, check_eligibility, get_monetization_requirements, get_rule_changes. Verb choice (calculate/check/get) also maps sensibly to the nature of each operation.
Tool Count5/5
Five tools is a tight, well-scoped set for a rules-and-gap-analysis server, with no redundant or trivial entries. Each tool earns its place by covering a distinct facet of the domain.
Completeness4/5
The surface covers the full analysis lifecycle: fetch rules, track rule changes, check eligibility, size the gap, and project growth pace. Only minor gaps exist, such as scenario comparison across multiple creators, which agents can work around by invoking tools repeatedly.
Available Tools
5 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.6/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), and the description adds meaningful behavior: caller metrics are plausibility-checked, VALUE_INCONSISTENT is returned when spotlight time exceeds view time, high view-time warnings, and unknowns are never guessed. It does not describe pagination or output shape, but with an output schema present that is acceptable.
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?
Three front-loaded sentences, the scoping and alternative-routing stated first. Some plausibility wording is duplicated verbatim between the description and the schema, which is mild redundancy but keeps the description self-contained.
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?
For a calculation tool with an output schema, the description covers the needed surface: what is computed, its input assumptions, error/warning behavior, and data-minimization constraints. Return-value explanation is correctly delegated to the output schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 75% and the nested metrics object is well annotated, so the baseline is 3. The description adds semantics beyond the schema: that metrics must be caller-supplied (never looked up), the data-minimization rule, and the already_enrolled gating of ongoing requirements.
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 (calculate) plus the exact outputs it produces (numeric shortfall, percent complete, binding constraint) and the input domain (creator's caller-supplied metrics). It explicitly names the two sibling tools it is NOT so an agent can disambiguate without opening a 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?
Provides explicit when-to-use ('when you need the exact numeric shortfall') and when-not-to-use, routing to calculate_growth_pace for pace to close and check_eligibility for pass/fail lists. The condition selecting each alternative is stated, not inferred.
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.4/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already establish readOnly, idempotent, non-destructive, closed-world behavior, so the safety profile needs no restating. The description adds genuinely new framing: the result is a projection with labeled assumptions rather than a prediction, which shapes how the agent should present output. It stops short of anything about error/unknown handling, but that is disclosed 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 operation type and the use condition, then the nature of the output, then the exclusions. No filler.
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 a rich schema, an output schema, and strong annotations, the description supplies what structured fields cannot: the routing decision and the projection-not-prediction expectation. It does not summarize that missing metrics yield 'unknowns' rather than guesses, but that constraint is already stated in 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 67% and the schema documents the nuanced fields (metrics, observed_daily_change, already_enrolled, plausibility warnings) in detail. The description only references target_days indirectly via 'within target_days' and adds no new parameter meaning, so the baseline of 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 (calculate) and the exact artifact produced (daily and weekly pace to close each numeric gap within target_days), including the qualitative form of the output (scenarios, labeled assumptions). It also names two siblings it is not, 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?
Explicit trigger (need pace to close a gap within target_days) plus explicit exclusions pointing at the correct alternatives: calculate_gap for gap size and get_monetization_requirements for rules. When-to-use, when-not-to-use, and alternatives are all present.
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 declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds that it operates on caller-supplied metrics only (no lookup) and enumerates the outcome space (meets/does_not_meet/unknown), which is meaningful behavioral context. It stops short of disclosing the no-verdict/discretion caveat that the schema description carries.
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 tight sentences: purpose first, then outputs, then the negative routing in one clause. Nothing is padded and the scoping information is front-loaded.
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 values need not be re-explained, and annotations cover safety. For a nested-object calculation tool the description is nearly complete, though it omits the caller-confirmation/unknown flow that the schema handles and the discretion disclaimer.
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%, so metrics, program, confirmations, metrics_as_of and already_enrolled are all documented in the schema. The tool description adds no parameter-level meaning 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 ('compare one creator's caller-supplied metrics with the published entry requirements') and names the sibling it is not for. An agent can distinguish it from calculate_gap and get_monetization_requirements 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?
Explicitly gives the selecting condition ('one creator's caller-supplied metrics') and the exclusions with named alternatives: 'Do not use it when you need the numeric shortfall (calculate_gap) or the rules without a creator (get_monetization_requirements).' Routing is fully specified.
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.
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 | |
| 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.4/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, non-destructive and closed-world, so the safety profile is covered. The description adds meaningful context beyond that: that this returns source-backed facts with provenance (source URL, verified_at, effective date) rather than derived judgements, which tells the agent the output is citable. It does not discuss size limits or ordering, but the annotations carry the safety burden.
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, zero waste, and the positive use case is front-loaded before the exclusion and the handoff. The leading 'FACT.' is terse and functional rather than padding.
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 and annotations covering safety, the description need not explain return values, and it correctly focuses on disambiguation. It is complete enough to call correctly; the only thin spot is that filter behavior (as_of versioning, 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%, and the embedded schema description already documents defaults (in-scope program list, historical records on request) and the check_eligibility/calculate_gap routing. The description text itself adds no per-parameter syntax or format detail, so baseline 3 is the correct ceiling when the schema does the heavy lifting.
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 ('get Snap's published creator-monetization rules') and enumerates exactly what the resource contains: thresholds, country lists, policy text, source URL, verified_at, effective date. The opening 'FACT' label plus the explicit contrast with scoring tools makes it unmistakable next to check_eligibility and calculate_gap.
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 explicit when-to-use ('use this first when you need ... the rules themselves') and explicit when-NOT ('Do not use it to score one creator or to compute a shortfall'). It names the two alternative siblings, check_eligibility and calculate_gap, and the condition that routes to them.
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).
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 | |
| 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.2/5.0
Behavior3/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 fully carried by structured data. The description adds the 'FACT' retrieval framing and clarifies scope (change history vs current state), but discloses no pagination limits, default lookback window, or result volume — those 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?
Two sentences, no wasted words, and the positive use case is front-loaded before the exclusions. Every clause carries routing information.
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 values need not be spelled out, and the description still names the returned fields. The gaps it leaves — baseline vs changes distinction, pagination behavior, default 90-day window — are covered by the schema, so the definition is sufficient to call the tool 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%, so the schema already documents since/until filtering semantics, program validation, cursor, and limit. The description itself contributes no parameter-level detail beyond the date-window concept, 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 ('what changed in Snap's monetization rules') and enumerates the returned fields (previous value, new value, source, detection date), which distinguishes it from a current-state query. An agent can identify this tool without opening the 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-to-use trigger ('when you need what changed ... since a date') and two explicit when-NOT cases with named alternatives: get_monetization_requirements for the current rule list and calculate_gap for a creator's gap. This is full routing guidance.
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_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
Read-only public Instagram data: profiles, posts, reels, stories, highlights, comments, hashtags.
Read-only MCP tools for Mana public creations, tags, creator profiles, and share pages.
Browse published podcasts, video shows, and screenplays. Read-only public discovery.
Read-only public Twitter data and TweetAPI docs for AI agents. Not affiliated with X Corp.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides read-only access to Meta Ads API, enabling campaign management, creative analysis, targeting research, and performance analytics via 39 tools.-
- FlicenseNot gradedqualityCmaintenanceEnables read-only inspection of ad-bid recommendations, scenario analysis, and explanation of threshold decisions using synthetic fixtures, without requiring live ad accounts or credentials.-
- FlicenseNot gradedqualityCmaintenanceEnables read-only Meta Ads reporting and diagnostics, plus safe, preview-before-apply mutations such as campaign creation, duplication, targeting replacement, and attribution changes.-
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.