FinderCloneSearchCreate

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/affiliaterail-com/json-schema/affiliaterail-com-finder-clone-search-create-schema.json",
  "title": "FinderCloneSearchCreate",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/affiliaterail-com-openapi.json#/components/schemas/FinderCloneSearchCreate",
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "pattern": "^(sample_)?fbr_",
      "description": "Which brand. Defaults to the organization's oldest."
    },
    "seeds": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 500
      },
      "maxItems": 20,
      "default": [],
      "description": "Links to creators you already rate, one per item: a website, a YouTube channel, an Instagram or TikTok profile, a newsletter or a podcast. A bare `@name` is refused, because it could be anyone on three platforms."
    },
    "prospect_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^(sample_)?fdi_",
        "description": "Prefixed id (`fdi_…`)"
      },
      "maxItems": 10,
      "description": "Or pick them from your own prospects. Ten creators at most, pasted and picked together."
    },
    "profile": {
      "type": "object",
      "properties": {
        "topics": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 60
          },
          "maxItems": 6,
          "description": "Two to six things they make content about, in the words a viewer would search. Each one becomes a website and a YouTube search."
        },
        "audience": {
          "type": "string",
          "maxLength": 200,
          "description": "Who watches or reads them, in one line"
        },
        "formats": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 30
          },
          "maxItems": 5,
          "description": "Reviews, tutorials, comparisons and so on"
        },
        "platforms": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "website",
              "youtube",
              "instagram",
              "tiktok",
              "newsletter",
              "podcast"
            ]
          }
        },
        "brands": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 60
              },
              "domain": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "name",
              "domain"
            ]
          },
          "maxItems": 8,
          "description": "Brands they already promote. The search also looks for others who promote them."
        },
        "size_band": {
          "type": "string",
          "enum": [
            "nano",
            "micro",
            "mid",
            "macro",
            "mixed",
            "unknown"
          ],
          "description": "nano is under 10k followers, micro 10k to 100k, mid 100k to 1m, macro over 1m"
        },
        "language": {
          "type": "string",
          "minLength": 2,
          "maxLength": 2,
          "description": "Two-letter language code"
        },
        "hashtags": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 40
          },
          "maxItems": 5,
          "description": "Without the #. Each one becomes an Instagram and TikTok search."
        }
      },
      "description": "The profile to search on, edited or as `clone-profile` wrote it. Leave it out and the creators are read again first, which costs nothing."
    },
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "ISO 3166-1 alpha-2, like GB or US"
    }
  },
  "required": [
    "country"
  ]
}