TrendsFast · Schema

TrendsApiV3Response

APITrendsSocialMediaSearchAI

Properties

Name Type Description
version string
result_id string
request_id string
operation string
generated_at string
read_at string
new_research boolean
data object
usage object
next_cursor object
View JSON Schema on GitHub

JSON Schema

trendsfast-trends-api-v3-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/trendsfast/json-schema/trendsfast-trends-api-v3-response-schema.json",
  "title": "TrendsApiV3Response",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/trendsfast-v3-openapi.json#/components/schemas/TrendsApiV3Response",
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "const": "trends-api-v3"
    },
    "result_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "request_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "operation": {
      "type": "string",
      "enum": [
        "global",
        "niche",
        "ask",
        "discover"
      ]
    },
    "generated_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "new_research": {
      "type": "boolean"
    },
    "data": {
      "anyOf": [
        {
          "$ref": "#/$defs/TrendIntelligenceV3"
        },
        {
          "type": "object",
          "properties": {
            "version": {
              "type": "string",
              "const": "trend-ask-v3"
            },
            "question": {
              "type": "string",
              "minLength": 3,
              "maxLength": 1000
            },
            "plan": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string",
                  "enum": [
                    "DISCOVER",
                    "FILTER",
                    "COMPARE",
                    "EXPLAIN",
                    "SUMMARIZE",
                    "FIND_CONVERSATIONS",
                    "FIND_CREATIVE_PATTERNS",
                    "ANALYZE_CUSTOMER_PROBLEMS",
                    "FIND_FEATURE_REQUESTS",
                    "COMPETITOR_ACTIVITY",
                    "SEARCH_DEMAND"
                  ]
                },
                "basis": {
                  "type": "string",
                  "const": "BOUNDED_DETERMINISTIC_PLAN"
                },
                "maximum_items": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 100
                },
                "provider_calls": {
                  "type": "number",
                  "const": 0
                },
                "filters": {
                  "type": "object",
                  "properties": {
                    "platforms": {
                      "minItems": 1,
                      "maxItems": 11,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "TIKTOK",
                          "YOUTUBE",
                          "INSTAGRAM",
                          "FACEBOOK",
                          "X",
                          "REDDIT",
                          "GOOGLE",
                          "BING",
                          "AI_SEARCH",
                          "WEB",
                          "FORUM",
                          "GITHUB"
                        ]
                      }
                    },
                    "content_types": {
                      "minItems": 1,
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "VIDEO",
                          "CONVERSATION",
                          "SEARCH",
                          "ARTICLE"
                        ]
                      }
                    },
                    "categories": {
                      "minItems": 1,
                      "maxItems": 10,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "COFFEE_BREWING",
                          "CONTENT_CREATION",
                          "CUSTOMER_DISCOVERY",
                          "SOFTWARE_DEVELOPMENT",
                          "PRODUCTIVITY",
                          "FITNESS",
                          "GARDENING",
                          "COOKING",
                          "SKINCARE",
                          "TRAVEL",
                          "AI",
                          "ECOMMERCE",
                          "FINANCE",
                          "EDUCATION",
                          "ENTERTAINMENT",
                          "SUSTAINABILITY",
                          "MARKETING",
                          "SALES",
                          "HEALTHCARE",
                          "HEALTH_WELLNESS",
                          "HOME_SERVICES",
                          "REAL_ESTATE",
                          "FASHION",
                          "BEAUTY",
                          "PETS",
                          "GAMING",
                          "PARENTING",
                          "AUTOMOTIVE",
                          "LEGAL",
                          "RESTAURANTS",
                          "SPORTS",
                          "CRYPTO",
                          "CAREERS",
                          "HOME_DECOR",
                          "WEDDINGS",
                          "OUTDOORS",
                          "PHOTOGRAPHY",
                          "CRAFTS_DIY",
                          "CYBERSECURITY",
                          "NONPROFIT",
                          "MUSIC_CREATION",
                          "DRINKS",
                          "GENERAL"
                        ]
                      }
                    },
                    "signals": {
                      "minItems": 1,
                      "maxItems": 8,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "POPULAR_NOW",
                          "RISING",
                          "EMERGING",
                          "RECURRING_PROBLEM",
                          "SEARCH_INTEREST",
                          "CREATIVE_PATTERN",
                          "NEW_DEVELOPMENT",
                          "INSUFFICIENT_EVIDENCE"
                        ]
                      }
                    },
                    "evidence_quality": {
                      "minItems": 1,
                      "maxItems": 3,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "ATTRIBUTED_METADATA",
                          "PERMITTED_TEXT",
                          "INSPECTED_MEDIA"
                        ]
                      }
                    },
                    "country": {
                      "type": "string",
                      "pattern": "^[A-Z]{2}$"
                    },
                    "region": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "observed_market": {
                      "type": "string",
                      "pattern": "^[A-Z]{2}$"
                    },
                    "language": {
                      "type": "string",
                      "pattern": "^[a-z]{2}(?:-[A-Z]{2})?$"
                    },
                    "observed_from": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    },
                    "observed_to": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    },
                    "lookback_hours": {
                      "default": 72,
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 720
                    },
                    "history_days": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 90
                    },
                    "compare_to": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    },
                    "limit": {
                      "default": 20,
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 100
                    }
                  },
                  "required": [
                    "lookback_hours",
                    "limit"
                  ],
                  "additionalProperties": false
                },
                "subject_terms": {
                  "maxItems": 8,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  }
                },
                "interpretation": {
                  "maxItems": 10,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  }
                }
              },
              "required": [
                "intent",
                "basis",
                "maximum_items",
                "provider_calls"
              ],
              "additionalProperties": false
            },
            "intelligence": {
              "$ref": "#/$defs/TrendIntelligenceV3"
            },
            "claims": {
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "evidence_ids": {
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z][a-z0-9_-]{2,95}$"
                    }
                  }
                },
                "required": [
                  "text",
                  "evidence_ids"
                ],
                "additionalProperties": false
              }
            },
            "answer": {
              "type": "string",
              "maxLength": 6000
            },
            "limitations": {
              "minItems": 1,
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 500
              }
            },
            "answer_status": {
              "type": "string",
              "enum": [
                "ANSWERED",
                "PARTIAL",
                "INSUFFICIENT_EVIDENCE",
                "NEEDS_CONTEXT",
                "NOT_COLLECTED"
              ]
            },
            "findings": {
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "TREND",
                      "CUSTOMER_PROBLEM",
                      "FEATURE_REQUEST",
                      "QUESTION_ASKED",
                      "HOOK_OBSERVED",
                      "FORMAT_OBSERVED",
                      "TITLE_OBSERVED",
                      "SEARCH_DEMAND",
                      "COMPETITOR_POST",
                      "COMPETITOR_MENTION",
                      "RELATED_DISCUSSION",
                      "REFERENCE"
                    ]
                  },
                  "item_id": {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9_-]{2,95}$"
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  },
                  "statement": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1200
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "TIKTOK",
                      "YOUTUBE",
                      "INSTAGRAM",
                      "FACEBOOK",
                      "X",
                      "REDDIT",
                      "GOOGLE",
                      "BING",
                      "AI_SEARCH",
                      "WEB",
                      "FORUM",
                      "GITHUB"
                    ]
                  },
                  "source": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  },
                  "url": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 2048,
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "metrics": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "published_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "ring": {
                    "type": "string",
                    "enum": [
                      "CORE",
                      "ADJACENT",
                      "GLOBAL"
                    ]
                  },
                  "evidence_ids": {
                    "minItems": 1,
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z][a-z0-9_-]{2,95}$"
                    }
                  }
                },
                "required": [
                  "kind",
                  "item_id",
                  "title",
                  "statement",
                  "platform",
                  "source",
                  "url",
                  "metrics",
                  "published_at",
                  "ring",
                  "evidence_ids"
                ],
                "additionalProperties": false
              }
            },
            "next_steps": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 600
              }
            },
            "missing_inputs": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 600
              }
            }
          },
          "required": [
            "version",
            "question",
            "plan",
            "intelligence",
            "claims",
            "answer",
            "limitations"
          ],
          "additionalProperties": false
        }
      ]
    },
    "usage": {
      "type": "object",
      "properties": {
        "credits_charged": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "read_charge": {
          "type": "number",
          "const": 0
        },
        "this_request_credits": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "catalog_version": {
          "type": "string",
          "minLength": 1,
          "maxLength": 180
        },
        "replayed": {
          "type": "boolean"
        }
      },
      "required": [
        "credits_charged",
        "read_charge",
        "this_request_credits",
        "catalog_version",
        "replayed"
      ],
      "additionalProperties": false
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 512
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "version",
    "result_id",
    "request_id",
    "operation",
    "generated_at",
    "read_at",
    "new_research",
    "data",
    "usage",
    "next_cursor"
  ],
  "additionalProperties": false,
  "$defs": {
    "TrendIntelligenceV3": {
      "type": "object",
      "properties": {
        "version": {
          "type": "string",
          "const": "trend-intelligence-v3"
        },
        "snapshot_id": {
          "type": "string",
          "pattern": "^[a-z][a-z0-9_-]{2,95}$"
        },
        "as_of": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "read_at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "classification_as_of": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "classification_window": {
          "type": "object",
          "properties": {
            "lookback_hours": {
              "type": "integer",
              "minimum": 1,
              "maximum": 720
            },
            "observed_from": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            },
            "observed_to": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            }
          },
          "required": [
            "lookback_hours",
            "observed_from",
            "observed_to"
          ],
          "additionalProperties": false
        },
        "context": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "CONFIRMED_CONTEXT",
                    "TEMPORARY_INPUT"
                  ]
                },
                "context_id": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "revision": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "fields": {
                  "minItems": 1,
                  "maxItems": 250,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "field": {
                        "type": "string",
                        "enum": [
                          "description",
                          "topic",
                          "problem",
                          "audience",
                          "exclusion",
                          "capability",
                          "job",
                          "industry",
                          "product_category",
                          "customer_interest",
                          "competitor",
                          "adjacent_category",
                          "market",
                          "language",
                          "platform",
                          "community",
                          "competitor_handle",
                          "competitor_domain",
                          "keyword"
                        ]
                      },
                      "value": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2000
                      },
                      "basis": {
                        "type": "string",
                        "enum": [
                          "OWNER_CONFIRMED",
                          "WEBSITE_OBSERVED",
                          "USER_ASSERTED",
                          "INFERRED"
                        ]
                      },
                      "evidence_ids": {
                        "maxItems": 20,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 180
                        }
                      }
                    },
                    "required": [
                      "field",
                      "value",
                      "basis",
                      "evidence_ids"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "kind",
                "context_id",
                "revision",
                "fields"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "items": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9_-]{2,95}$"
              },
              "cluster_id": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9_-]{2,95}$"
              },
              "cluster_assignment": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9_-]{2,95}$"
                  },
                  "entity_id": {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9_-]{2,95}$"
                  },
                  "cluster_id": {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9_-]{2,95}$"
                  },
                  "event_id": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                  },
                  "assigned_at": {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                  },
                  "method_version": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  },
                  "change": {
                    "type": "string",
                    "enum": [
                      "INITIAL",
                      "MERGE",
                      "SPLIT"
                    ]
                  },
                  "predecessor_cluster_ids": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z][a-z0-9_-]{2,95}$"
                    }
                  }
                },
                "required": [
                  "id",
                  "entity_id",
                  "cluster_id",
                  "event_id",
                  "assigned_at",
                  "method_version",
                  "change",
                  "predecessor_cluster_ids"
                ],
                "additionalProperties": false
              },
              "history": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "COMPARABLE",
                      "NO_BASELINE",
                      "INSUFFICIENT_HISTORY",
                      "NOT_OBSERVED"
                    ]
                  },
                  "first_retained_observed_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "last_retained_observed_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "requested_baseline_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "baseline_observation_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^[a-z][a-z0-9_-]{2,95}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "snapshots": {
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "observation_id": {
                          "type": "string",
                          "pattern": "^[a-z][a-z0-9_-]{2,95}$"
                        },
                        "source": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 500
                        },
                        "observed_at": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                        },
                        "metrics": {
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "object",
                    

# --- truncated at 32 KB (149 KB total) ---
# Full source: https://artifacts.apis.io/trendsfast/json-schema/trendsfast-trends-api-v3-response-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/trendsfast-trends-api-v3-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.