{
  "openapi": "3.1.0",
  "info": {
    "title": "Creator Sponsorship Intelligence API",
    "version": "1.0.0",
    "description": "Discover creators and sponsorship signals across 12 platforms with provenance-aware observations, exports and clearly labeled estimates.",
    "x-pricing-model": "payg",
    "x-free-tier-calls": 0,
    "x-docs-url": "",
    "x-dakidarts-contract-status": "published",
    "x-dakidarts-execution-status": "source-only"
  },
  "servers": [
    {
      "url": "https://api.dakidarts.com/creator-sponsorship-intelligence-api",
      "description": "Dakidarts direct gateway"
    }
  ],
  "tags": [
    {
      "name": "Operations",
      "description": "Operations endpoints sourced from the Creator Sponsorship Intelligence API implementation."
    },
    {
      "name": "Creators",
      "description": "Creators endpoints sourced from the Creator Sponsorship Intelligence API implementation."
    },
    {
      "name": "Audience",
      "description": "Audience endpoints sourced from the Creator Sponsorship Intelligence API implementation."
    },
    {
      "name": "Engagement",
      "description": "Engagement endpoints sourced from the Creator Sponsorship Intelligence API implementation."
    },
    {
      "name": "Sponsorships",
      "description": "Sponsorships endpoints sourced from the Creator Sponsorship Intelligence API implementation."
    },
    {
      "name": "Niches",
      "description": "Niches endpoints sourced from the Creator Sponsorship Intelligence API implementation."
    },
    {
      "name": "Observations",
      "description": "Observations endpoints sourced from the Creator Sponsorship Intelligence API implementation."
    },
    {
      "name": "Discovery",
      "description": "Discovery endpoints sourced from the Creator Sponsorship Intelligence API implementation."
    }
  ],
  "paths": {
    "/healthz": {
      "get": {
        "summary": "Healthz",
        "description": "Liveness check",
        "operationId": "creator-sponsorship-intelligence-api_get_healthz",
        "tags": [
          "Operations"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/readyz": {
      "get": {
        "summary": "Readyz",
        "description": "Database readiness check",
        "operationId": "creator-sponsorship-intelligence-api_get_readyz",
        "tags": [
          "Operations"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/v1/creators/search": {
      "get": {
        "summary": "Search",
        "description": "Search and filter creators",
        "operationId": "creator-sponsorship-intelligence-api_get_v1_creators_search",
        "tags": [
          "Creators"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string",
              "default": ""
            }
          },
          {
            "name": "platform",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "niche",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_followers",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "max_followers",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "verified",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "integer",
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "integer",
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "pagination",
                    "query"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "display_name",
                          "bio",
                          "website_url",
                          "country",
                          "profiles",
                          "primary_followers",
                          "top_niche",
                          "niche_score",
                          "audience_confidence",
                          "updated_at"
                        ],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "bio": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "country": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "profiles": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "id",
                                "platform",
                                "handle",
                                "platform_user_id",
                                "profile_url",
                                "followers",
                                "following",
                                "post_count",
                                "verified",
                                "source_type",
                                "confidence",
                                "first_seen_at",
                                "last_seen_at"
                              ],
                              "properties": {
                                "id": {
                                  "type": "string"
                                },
                                "handle": {
                                  "type": "string"
                                },
                                "platform": {
                                  "type": "string"
                                },
                                "verified": {
                                  "type": "boolean"
                                },
                                "followers": {
                                  "anyOf": [
                                    {
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "following": {
                                  "anyOf": [
                                    {
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "confidence": {
                                  "type": "string"
                                },
                                "post_count": {
                                  "anyOf": [
                                    {
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "profile_url": {
                                  "type": "string",
                                  "format": "uri",
                                  "minLength": 1
                                },
                                "source_type": {
                                  "type": "string"
                                },
                                "last_seen_at": {
                                  "type": "string",
                                  "format": "date-time"
                                },
                                "first_seen_at": {
                                  "type": "string",
                                  "format": "date-time"
                                },
                                "platform_user_id": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            }
                          },
                          "top_niche": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "updated_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "niche_score": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "website_url": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "uri",
                                "minLength": 1
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "display_name": {
                            "type": "string"
                          },
                          "primary_followers": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "audience_confidence": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        }
                      }
                    },
                    "query": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "pagination": {
                      "type": "object",
                      "required": [
                        "page",
                        "page_size",
                        "total",
                        "total_pages"
                      ],
                      "properties": {
                        "page": {
                          "type": "integer"
                        },
                        "total": {
                          "type": "integer"
                        },
                        "page_size": {
                          "type": "integer"
                        },
                        "total_pages": {
                          "type": "integer"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/v1/creators/{creator_id}": {
      "get": {
        "summary": "Creator Detail",
        "description": "Creator profile and summary intelligence",
        "operationId": "creator-sponsorship-intelligence-api_get_v1_creators_{creator_id}",
        "tags": [
          "Creators"
        ],
        "parameters": [
          {
            "name": "creator_id",
            "in": "path",
            "required": true,
            "description": "",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "id",
                    "display_name",
                    "bio",
                    "website_url",
                    "country",
                    "profiles",
                    "primary_followers",
                    "top_niche",
                    "niche_score",
                    "audience_confidence",
                    "updated_at",
                    "languages",
                    "niches",
                    "audience_estimate",
                    "partnerships"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "bio": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "niches": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "niche",
                          "score",
                          "rank",
                          "model_version",
                          "computed_at"
                        ],
                        "properties": {
                          "rank": {
                            "type": "integer"
                          },
                          "niche": {
                            "type": "string"
                          },
                          "score": {
                            "type": "string",
                            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                          },
                          "computed_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "model_version": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "country": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "profiles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "platform",
                          "handle",
                          "platform_user_id",
                          "profile_url",
                          "followers",
                          "following",
                          "post_count",
                          "verified",
                          "source_type",
                          "confidence",
                          "first_seen_at",
                          "last_seen_at"
                        ],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "handle": {
                            "type": "string"
                          },
                          "platform": {
                            "type": "string"
                          },
                          "verified": {
                            "type": "boolean"
                          },
                          "followers": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "following": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "confidence": {
                            "type": "string"
                          },
                          "post_count": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "profile_url": {
                            "type": "string",
                            "format": "uri",
                            "minLength": 1
                          },
                          "source_type": {
                            "type": "string"
                          },
                          "last_seen_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "first_seen_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "platform_user_id": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        }
                      }
                    },
                    "languages": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "top_niche": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "niche_score": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "website_url": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri",
                          "minLength": 1
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "display_name": {
                      "type": "string"
                    },
                    "partnerships": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "brand_name",
                          "brand_domain",
                          "evidence_text",
                          "content_url",
                          "disclosure_terms",
                          "status",
                          "confidence",
                          "detected_at"
                        ],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "brand_name": {
                            "type": "string"
                          },
                          "confidence": {
                            "type": "string"
                          },
                          "content_url": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "uri",
                                "minLength": 1
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "detected_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "brand_domain": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "evidence_text": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "disclosure_terms": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "audience_estimate": {
                      "anyOf": [
                        {
                          "type": "object",
                          "required": [
                            "estimated_reach_min",
                            "estimated_reach_max",
                            "active_audience_min",
                            "active_audience_max",
                            "confidence",
                            "methodology",
                            "computed_at"
                          ],
                          "properties": {
                            "confidence": {
                              "type": "string"
                            },
                            "computed_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "methodology": {
                              "type": "string"
                            },
                            "active_audience_max": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "active_audience_min": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "estimated_reach_max": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "estimated_reach_min": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "primary_followers": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "audience_confidence": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/v1/creators/{creator_id}/audience": {
      "get": {
        "summary": "Creator Audience",
        "description": "Observed profiles and latest audience estimate",
        "operationId": "creator-sponsorship-intelligence-api_get_v1_creators_{creator_id}_audience",
        "tags": [
          "Audience"
        ],
        "parameters": [
          {
            "name": "creator_id",
            "in": "path",
            "required": true,
            "description": "",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "creator_id",
                    "profiles",
                    "latest_estimate",
                    "observed_followers_total"
                  ],
                  "properties": {
                    "profiles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "platform",
                          "handle",
                          "platform_user_id",
                          "profile_url",
                          "followers",
                          "following",
                          "post_count",
                          "verified",
                          "source_type",
                          "confidence",
                          "first_seen_at",
                          "last_seen_at"
                        ],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "handle": {
                            "type": "string"
                          },
                          "platform": {
                            "type": "string"
                          },
                          "verified": {
                            "type": "boolean"
                          },
                          "followers": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "following": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "confidence": {
                            "type": "string"
                          },
                          "post_count": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "profile_url": {
                            "type": "string",
                            "format": "uri",
                            "minLength": 1
                          },
                          "source_type": {
                            "type": "string"
                          },
                          "last_seen_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "first_seen_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "platform_user_id": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        }
                      }
                    },
                    "creator_id": {
                      "type": "string"
                    },
                    "latest_estimate": {
                      "anyOf": [
                        {
                          "type": "object",
                          "required": [
                            "estimated_reach_min",
                            "estimated_reach_max",
                            "active_audience_min",
                            "active_audience_max",
                            "confidence",
                            "methodology",
                            "computed_at"
                          ],
                          "properties": {
                            "confidence": {
                              "type": "string"
                            },
                            "computed_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "methodology": {
                              "type": "string"
                            },
                            "active_audience_max": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "active_audience_min": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "estimated_reach_max": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "estimated_reach_min": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "observed_followers_total": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/v1/creators/{creator_id}/engagement": {
      "get": {
        "summary": "Creator Engagement",
        "description": "View and engagement metrics by platform",
        "operationId": "creator-sponsorship-intelligence-api_get_v1_creators_{creator_id}_engagement",
        "tags": [
          "Engagement"
        ],
        "parameters": [
          {
            "name": "creator_id",
            "in": "path",
            "required": true,
            "description": "",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "integer",
              "default": 90
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "creator_id",
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "creator_id",
                          "platform",
                          "posts_analyzed",
                          "average_views",
                          "median_views",
                          "average_likes",
                          "average_comments",
                          "average_shares",
                          "engagement_rate",
                          "measurement_basis",
                          "observed_from",
                          "observed_to"
                        ],
                        "properties": {
                          "platform": {
                            "type": "string"
                          },
                          "creator_id": {
                            "type": "string"
                          },
                          "observed_to": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "median_views": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "average_likes": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "average_views": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "observed_from": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "average_shares": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "posts_analyzed": {
                            "type": "integer"
                          },
                          "engagement_rate": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "average_comments": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "measurement_basis": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "creator_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/v1/creators/{creator_id}/partnerships": {
      "get": {
        "summary": "Creator Partnerships",
        "description": "Detected and verified brand mentions",
        "operationId": "creator-sponsorship-intelligence-api_get_v1_creators_{creator_id}_partnerships",
        "tags": [
          "Sponsorships"
        ],
        "parameters": [
          {
            "name": "creator_id",
            "in": "path",
            "required": true,
            "description": "",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "integer",
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "creator_id",
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "brand_name",
                          "brand_domain",
                          "evidence_text",
                          "content_url",
                          "disclosure_terms",
                          "status",
                          "confidence",
                          "detected_at"
                        ],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "brand_name": {
                            "type": "string"
                          },
                          "confidence": {
                            "type": "string"
                          },
                          "content_url": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "uri",
                                "minLength": 1
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "detected_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "brand_domain": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "evidence_text": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "disclosure_terms": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "creator_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/v1/creators/{creator_id}/niches": {
      "get": {
        "summary": "Creator Niches",
        "description": "Ranked niche classification",
        "operationId": "creator-sponsorship-intelligence-api_get_v1_creators_{creator_id}_niches",
        "tags": [
          "Niches"
        ],
        "parameters": [
          {
            "name": "creator_id",
            "in": "path",
            "required": true,
            "description": "",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "creator_id",
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "niche",
                          "score",
                          "rank",
                          "model_version",
                          "computed_at"
                        ],
                        "properties": {
                          "rank": {
                            "type": "integer"
                          },
                          "niche": {
                            "type": "string"
                          },
                          "score": {
                            "type": "string",
                            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                          },
                          "computed_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "model_version": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "creator_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/v1/creators/{creator_id}/observations": {
      "get": {
        "summary": "Creator Observations",
        "description": "Raw metric observations with provenance",
        "operationId": "creator-sponsorship-intelligence-api_get_v1_creators_{creator_id}_observations",
        "tags": [
          "Observations"
        ],
        "parameters": [
          {
            "name": "creator_id",
            "in": "path",
            "required": true,
            "description": "",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "metric_name",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source_type",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "integer",
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "creator_id",
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "metric_name",
                          "value",
                          "observed_at",
                          "source_type",
                          "source_url",
                          "confidence",
                          "is_estimated"
                        ],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "value": {
                            "type": "string",
                            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                          },
                          "confidence": {
                            "type": "string"
                          },
                          "source_url": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "uri",
                                "minLength": 1
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "metric_name": {
                            "type": "string"
                          },
                          "observed_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "source_type": {
                            "type": "string"
                          },
                          "is_estimated": {
                            "type": "boolean"
                          }
                        }
                      }
                    },
                    "creator_id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/v1/sources": {
      "get": {
        "summary": "Sources",
        "description": "Feed freshness and source coverage",
        "operationId": "creator-sponsorship-intelligence-api_get_v1_sources",
        "tags": [
          "Discovery"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "source",
                      "status",
                      "last_success_at",
                      "last_run_at",
                      "last_run_status",
                      "last_error",
                      "creators_processed",
                      "profiles_processed",
                      "content_processed",
                      "creator_count",
                      "profile_count",
                      "freshness_seconds"
                    ],
                    "properties": {
                      "source": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string"
                      },
                      "last_error": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "last_run_at": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "creator_count": {
                        "type": "integer"
                      },
                      "profile_count": {
                        "type": "integer"
                      },
                      "last_run_status": {
                        "type": "string"
                      },
                      "last_success_at": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "date-time"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "content_processed": {
                        "type": "integer"
                      },
                      "freshness_seconds": {
                        "type": "integer"
                      },
                      "creators_processed": {
                        "type": "integer"
                      },
                      "profiles_processed": {
                        "type": "integer"
                      }
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ]
}