{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Natural-language semantic discovery query by topic, niche, audience, geography, or content style. Do not pass exact handles or usernames here; use get_profile, lookup_profiles, or autocomplete_creators instead."
    },
    "platforms": {
      "description": "Platforms to search. Omit for all.",
      "type": "array",
      "items": {
        "$ref": "#/definitions/Platform"
      }
    },
    "limit": {
      "default": 25,
      "description": "Maximum results to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "creator_kinds": {
      "description": "Optional creator kind filter. Omit for no creator-kind filter.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "INFLUENCER",
          "THEME_PAGE"
        ]
      }
    },
    "min_followers": {
      "description": "Minimum follower count.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "max_followers": {
      "description": "Maximum follower count.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "min_engagement_rate": {
      "description": "Minimum engagement rate as a percentage from 0 to 100.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "max_engagement_rate": {
      "description": "Maximum engagement rate as a percentage from 0 to 100.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "verified": {
      "description": "When set, only return verified or unverified creators.",
      "type": "boolean"
    },
    "platform": {
      "description": "Optional platform to narrow username matching.",
      "allOf": [
        {
          "$ref": "#/definitions/Platform"
        }
      ]
    },
    "scope": {
      "default": "all_platforms",
      "description": "Which linked platforms to include in each lookup result.",
      "type": "string",
      "enum": [
        "creator_only",
        "matched_platforms",
        "all_platforms"
      ]
    },
    "query_type": {
      "default": "auto",
      "description": "Use creator_lookup for specific names/handles and semantic_discovery for topical/niche discovery. Auto routes exact handles and profile URLs to lookup, and keeps legacy semantic-search behavior otherwise.",
      "type": "string",
      "enum": [
        "auto",
        "creator_lookup",
        "semantic_discovery"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "Platform": {
      "type": "string",
      "enum": [
        "instagram"
      ],
      "description": "Social media platform",
      "example": "instagram"
    }
  }
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Natural-language semantic discovery query by topic, niche, audience, geography, or content style. Do not pass exact handles or usernames here; use get_profile, lookup_profiles, or autocomplete_creators instead."
    },
    "platforms": {
      "description": "Platforms to search. Omit for all.",
      "type": "array",
      "items": {
        "$ref": "#/definitions/Platform"
      }
    },
    "limit": {
      "default": 25,
      "description": "Maximum results to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "creator_kinds": {
      "description": "Optional creator kind filter. Omit for no creator-kind filter.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "INFLUENCER",
          "THEME_PAGE"
        ]
      }
    },
    "min_followers": {
      "description": "Minimum follower count.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "max_followers": {
      "description": "Maximum follower count.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "min_engagement_rate": {
      "description": "Minimum engagement rate as a percentage from 0 to 100.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "max_engagement_rate": {
      "description": "Maximum engagement rate as a percentage from 0 to 100.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "verified": {
      "description": "When set, only return verified or unverified creators.",
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "Platform": {
      "type": "string",
      "enum": [
        "instagram"
      ],
      "description": "Social media platform",
      "example": "instagram"
    }
  }
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "Search query (min 2 characters)",
      "example": "fitness"
    },
    "platform": {
      "description": "Filter by platform",
      "allOf": [
        {
          "$ref": "#/definitions/Platform"
        }
      ]
    },
    "limit": {
      "default": 5,
      "description": "Maximum results to return",
      "example": 5,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "scope": {
      "default": "all_platforms",
      "description": "Which platforms to include in results",
      "example": "all_platforms",
      "type": "string",
      "enum": [
        "creator_only",
        "matched_platforms",
        "all_platforms"
      ]
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {
    "Platform": {
      "type": "string",
      "enum": [
        "instagram"
      ],
      "description": "Social media platform",
      "example": "instagram"
    }
  }
}

{
  "type": "object",
  "properties": {
    "seed_creator_ids": {
      "description": "Seed creators identified by canonical Influship creator UUID.",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "creator_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)$",
            "description": "Canonical Influship creator UUID."
          },
          "weight": {
            "default": 1,
            "description": "Relative seed weight from 0 to 1. Omit for the default weight of 1.",
            "type": "number",
            "minimum": 0,
            "maximum": 1
          }
        },
        "required": [
          "creator_id"
        ],
        "additionalProperties": false
      }
    },
    "seed_profiles": {
      "description": "Seed creators identified by platform and username.",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "platform": {
            "description": "Social platform for the username.",
            "allOf": [
              {
                "$ref": "#/definitions/Platform"
              }
            ]
          },
          "username": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Platform username or handle without the @ sign."
          },
          "weight": {
            "default": 1,
            "description": "Relative seed weight from 0 to 1. Omit for the default weight of 1.",
            "type": "number",
            "minimum": 0,
            "maximum": 1
          }
        },
        "required": [
          "platform",
          "username"
        ],
        "additionalProperties": false
      }
    },
    "limit": {
      "default": 25,
      "description": "Maximum results to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Pagination cursor from a previous response.",
      "type": "string"
    },
    "min_followers": {
      "description": "Minimum follower count.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "max_followers": {
      "description": "Maximum follower count.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "min_engagement_rate": {
      "description": "Minimum engagement rate as a percentage from 0 to 100.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "max_engagement_rate": {
      "description": "Maximum engagement rate as a percentage from 0 to 100.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "verified": {
      "description": "When set, only return verified or unverified creators.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "Platform": {
      "type": "string",
      "enum": [
        "instagram"
      ],
      "description": "Social media platform",
      "example": "instagram"
    }
  }
}

{
  "type": "object",
  "properties": {
    "creator_ids": {
      "description": "Candidate creators identified by canonical Influship creator UUID.",
      "maxItems": 100,
      "type": "array",
      "items": {
        "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)$"
      }
    },
    "profiles": {
      "description": "Candidate creators identified by platform and username.",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "platform": {
            "description": "Social platform for the username.",
            "allOf": [
              {
                "$ref": "#/definitions/Platform"
              }
            ]
          },
          "username": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Platform username or handle without the @ sign."
          }
        },
        "required": [
          "platform",
          "username"
        ],
        "additionalProperties": false
      }
    },
    "intent_query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Campaign brief or matching intent."
    },
    "intent_context": {
      "description": "Optional extra campaign context, audience, brand values, or prior collabs.",
      "type": "string",
      "maxLength": 2000
    }
  },
  "required": [
    "intent_query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "Platform": {
      "type": "string",
      "enum": [
        "instagram"
      ],
      "description": "Social media platform",
      "example": "instagram"
    }
  }
}

{
  "type": "object",
  "properties": {
    "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)$",
      "description": "Creator unique identifier",
      "example": "123e4567-e89b-12d3-a456-426614174000"
    },
    "platform": {
      "description": "Social platform for the username.",
      "allOf": [
        {
          "$ref": "#/definitions/Platform"
        }
      ]
    },
    "username": {
      "description": "Platform username or handle without the @ sign.",
      "type": "string",
      "minLength": 1,
      "maxLength": 50
    },
    "include": {
      "description": "Additional data to include in response",
      "example": [
        "profiles"
      ],
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "profiles"
        ]
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "Platform": {
      "type": "string",
      "enum": [
        "instagram"
      ],
      "description": "Social media platform",
      "example": "instagram"
    }
  }
}

{
  "type": "object",
  "properties": {
    "platform": {
      "description": "Social platform for the username.",
      "allOf": [
        {
          "$ref": "#/definitions/Platform"
        }
      ]
    },
    "username": {
      "type": "string",
      "minLength": 1,
      "maxLength": 50,
      "description": "Platform username or handle without the @ sign."
    }
  },
  "required": [
    "platform",
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "Platform": {
      "type": "string",
      "enum": [
        "instagram"
      ],
      "description": "Social media platform",
      "example": "instagram"
    }
  }
}

{
  "type": "object",
  "properties": {
    "profiles": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "$ref": "#/definitions/ProfileLookupItem"
      },
      "description": "Profiles to lookup"
    }
  },
  "required": [
    "profiles"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Batch lookup profiles request",
  "examples": [
    {
      "profiles": [
        {
          "platform": "instagram",
          "username": "fitness_coach_jane"
        },
        {
          "platform": "instagram",
          "username": "wellness_guru"
        },
        {
          "platform": "instagram",
          "username": "healthy_eating_tips"
        }
      ]
    }
  ],
  "definitions": {
    "ProfileLookupItem": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/definitions/Platform"
        },
        "username": {
          "type": "string",
          "minLength": 1,
          "maxLength": 50,
          "description": "Username to lookup",
          "example": "fitness_coach_jane"
        }
      },
      "required": [
        "platform",
        "username"
      ]
    },
    "Platform": {
      "type": "string",
      "enum": [
        "instagram"
      ],
      "description": "Social media platform",
      "example": "instagram"
    }
  }
}

{
  "type": "object",
  "properties": {
    "platform": {
      "description": "Platform (required with username)",
      "allOf": [
        {
          "$ref": "#/definitions/Platform"
        }
      ]
    },
    "username": {
      "description": "Username (required with platform)",
      "example": "fitness_coach_jane",
      "type": "string",
      "minLength": 1,
      "maxLength": 50
    },
    "creator_id": {
      "description": "Creator ID (use this OR platform+username)",
      "example": "123e4567-e89b-12d3-a456-426614174000",
      "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)$"
    },
    "limit": {
      "default": 12,
      "description": "Maximum posts to return",
      "example": 12,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "sort": {
      "default": "recent",
      "description": "Sort order",
      "allOf": [
        {
          "$ref": "#/definitions/PostSort"
        }
      ]
    },
    "cursor": {
      "description": "Opaque keyset cursor from next_cursor. A cursor is bound to the sort order that produced it; using it with another sort returns 400.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {
    "Platform": {
      "type": "string",
      "enum": [
        "instagram"
      ],
      "description": "Social media platform",
      "example": "instagram"
    },
    "PostSort": {
      "type": "string",
      "enum": [
        "recent",
        "top_engagement",
        "most_likes",
        "most_views",
        "most_comments"
      ],
      "description": "Stable post ordering. top_engagement uses (likes + comments) / views, with posts that have no measurable views sorted last.",
      "example": "recent"
    }
  }
}

{
  "type": "object",
  "properties": {
    "shortcode": {
      "type": "string",
      "minLength": 1,
      "description": "Instagram post shortcode from a /p/, /reel/, or /tv/ URL"
    }
  },
  "required": [
    "shortcode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "shortcodes": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Instagram post shortcodes from /p/, /reel/, or /tv/ URLs"
    }
  },
  "required": [
    "shortcodes"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "shortcode": {
      "type": "string",
      "minLength": 1,
      "description": "Instagram post shortcode from a /p/, /reel/, or /tv/ URL"
    },
    "language": {
      "description": "Optional transcript language code. Omit to auto-detect.",
      "type": "string",
      "minLength": 2
    }
  },
  "required": [
    "shortcode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "shortcodes": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Instagram video post shortcodes from /p/, /reel/, or /tv/ URLs"
    },
    "language": {
      "description": "Optional transcript language code. Omit to auto-detect.",
      "type": "string",
      "minLength": 2
    }
  },
  "required": [
    "shortcodes"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}