{
  "openapi": "3.1.0",
  "info": {
    "title": "Sigpik Free Public API",
    "version": "1.0.0",
    "description": "Shared daily selections, no account or API key. No pagination, arbitrary filters, historical editions or bulk export. Rankings are monthly estimates. Signals are delayed highlights, not a complete event stream."
  },
  "servers": [
    {
      "url": "https://sigpik.com/api/public/v1"
    }
  ],
  "security": [],
  "paths": {
    "/rankings": {
      "get": {
        "operationId": "readFreeGrowthBrief",
        "security": [],
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "en",
                "zh-CN"
              ],
              "default": "en"
            }
          }
        ],
        "description": "Up to five selected records. Only locale is accepted. Unknown or duplicate query parameters return 400. Poll daily. Edge rate limit is 120 requests/IP/minute; 429 includes Retry-After. No monthly API quota.",
        "responses": {
          "200": {
            "description": "Latest daily publication. Empty items is valid. stale=true means publication is delayed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "version",
                    "kind",
                    "edition",
                    "published_at",
                    "stale",
                    "locale",
                    "selection",
                    "max_items",
                    "items",
                    "source_url",
                    "documentation_url"
                  ],
                  "properties": {
                    "version": {
                      "const": "1"
                    },
                    "kind": {
                      "const": "rankings"
                    },
                    "edition": {
                      "type": "string",
                      "format": "date"
                    },
                    "published_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "locale": {
                      "enum": [
                        "en",
                        "zh-CN"
                      ]
                    },
                    "selection": {
                      "type": "string"
                    },
                    "max_items": {
                      "const": 5
                    },
                    "items": {
                      "type": "array",
                      "maxItems": 5,
                      "items": {
                        "$schema": "https://json-schema.org/draft/2020-12/schema",
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 500
                          },
                          "rank": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 5
                          },
                          "product": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": "string",
                                "format": "uri"
                              }
                            },
                            "required": [
                              "name",
                              "slug",
                              "url"
                            ],
                            "additionalProperties": false
                          },
                          "period": {
                            "type": "object",
                            "properties": {
                              "current_month": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                              },
                              "previous_month": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                              }
                            },
                            "required": [
                              "current_month",
                              "previous_month"
                            ],
                            "additionalProperties": false
                          },
                          "estimated_visits": {
                            "type": "number",
                            "minimum": 0
                          },
                          "previous_estimated_visits": {
                            "type": "number",
                            "exclusiveMinimum": 0
                          },
                          "visits_change": {
                            "type": "number",
                            "exclusiveMinimum": 0
                          },
                          "growth_rate": {
                            "type": "number",
                            "exclusiveMinimum": 0
                          }
                        },
                        "required": [
                          "id",
                          "rank",
                          "product",
                          "period",
                          "estimated_visits",
                          "previous_estimated_visits",
                          "visits_change",
                          "growth_rate"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "source_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "documentation_url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              }
            }
          },
          "304": {
            "description": "Unchanged; If-None-Match matched the ETag."
          },
          "400": {
            "description": "Unsupported query."
          },
          "429": {
            "description": "Wait for Retry-After."
          },
          "503": {
            "description": "Publication unavailable or older than 48 hours. Retry later."
          }
        }
      }
    },
    "/signals": {
      "get": {
        "operationId": "readFreeSignalBrief",
        "security": [],
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "en",
                "zh-CN"
              ],
              "default": "en"
            }
          }
        ],
        "description": "Up to five selected records. Only locale is accepted. Unknown or duplicate query parameters return 400. Poll daily. Edge rate limit is 120 requests/IP/minute; 429 includes Retry-After. No monthly API quota.",
        "responses": {
          "200": {
            "description": "Latest daily publication. Empty items is valid. stale=true means publication is delayed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "version",
                    "kind",
                    "edition",
                    "published_at",
                    "stale",
                    "locale",
                    "selection",
                    "max_items",
                    "items",
                    "source_url",
                    "documentation_url"
                  ],
                  "properties": {
                    "version": {
                      "const": "1"
                    },
                    "kind": {
                      "const": "signals"
                    },
                    "edition": {
                      "type": "string",
                      "format": "date"
                    },
                    "published_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "locale": {
                      "enum": [
                        "en",
                        "zh-CN"
                      ]
                    },
                    "selection": {
                      "type": "string"
                    },
                    "max_items": {
                      "const": 5
                    },
                    "items": {
                      "type": "array",
                      "maxItems": 5,
                      "items": {
                        "$schema": "https://json-schema.org/draft/2020-12/schema",
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "pattern": "^cs_[0-9a-f]{64}$"
                          },
                          "product": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": "string",
                                "format": "uri"
                              }
                            },
                            "required": [
                              "name",
                              "slug",
                              "url"
                            ],
                            "additionalProperties": false
                          },
                          "type": {
                            "type": "string",
                            "pattern": "^[a-z_]{1,80}$"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "direction": {
                            "type": "string",
                            "enum": [
                              "up",
                              "down",
                              "neutral",
                              "mixed",
                              "unknown"
                            ]
                          },
                          "before": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "value": {
                                    "anyOf": [
                                      {
                                        "type": "number"
                                      },
                                      {
                                        "type": "boolean"
                                      }
                                    ]
                                  },
                                  "unit": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "visits",
                                          "percent",
                                          "ratio",
                                          "count",
                                          "usd",
                                          "pages",
                                          "users",
                                          "domains"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "value",
                                  "unit"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "after": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "value": {
                                    "anyOf": [
                                      {
                                        "type": "number"
                                      },
                                      {
                                        "type": "boolean"
                                      }
                                    ]
                                  },
                                  "unit": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "visits",
                                          "percent",
                                          "ratio",
                                          "count",
                                          "usd",
                                          "pages",
                                          "users",
                                          "domains"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "value",
                                  "unit"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "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))$"
                          },
                          "published_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))$"
                          },
                          "period": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "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"
                                  }
                                ]
                              },
                              "end": {
                                "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"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "id",
                          "product",
                          "type",
                          "title",
                          "summary",
                          "direction",
                          "before",
                          "after",
                          "observed_at",
                          "published_at",
                          "period"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "source_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "documentation_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "observation_window": {
                      "type": "object",
                      "properties": {
                        "start": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "end": {
                          "type": "string",
                          "format": "date-time"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "304": {
            "description": "Unchanged; If-None-Match matched the ETag."
          },
          "400": {
            "description": "Unsupported query."
          },
          "429": {
            "description": "Wait for Retry-After."
          },
          "503": {
            "description": "Publication unavailable or older than 48 hours. Retry later."
          }
        }
      }
    }
  }
}