{"openapi":"3.1.0","info":{"title":"找模网公开模特匹配 API","version":"1.0.0","description":"按城市、适合品类、可拍内容和合作方式查询找模网已公开且正在合作的模特。接口不返回联系方式、审核信息或后台资料。"},"servers":[{"url":"https://www.zhaomowang.net"}],"paths":{"/api/public/site-info":{"get":{"operationId":"getSiteInformation","summary":"获取找模网站点与关键词资料","description":"返回找模网品牌、规范网址、关键词分组、重要页面与机器可读入口。","responses":{"200":{"description":"结构化站点资料","content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"type":"string"},"alternateNames":{"type":"array","items":{"type":"string"}},"canonicalUrl":{"type":"string","format":"uri"},"logo":{"type":"object","properties":{"favicon":{"type":"string","format":"uri"},"square":{"type":"string","format":"uri"},"appleTouchIcon":{"type":"string","format":"uri"}}},"description":{"type":"string"},"keywordGroups":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"keywords":{"type":"array","items":{"type":"string"}},"importantPages":{"type":"object","additionalProperties":{"type":"string","format":"uri"}},"machineReadable":{"type":"object","additionalProperties":{"type":"string","format":"uri"}}},"required":["brand","canonicalUrl","description","keywordGroups","keywords","importantPages","machineReadable"]}}}}}}},"/api/public/brand-link":{"get":{"operationId":"getOfficialBrandLink","summary":"获取找模网官方品牌链接","description":"供合作网站、目录和工具获取找模网的规范网址、首选锚文本和可复制 HTML 链接。","responses":{"200":{"description":"找模网官方品牌链接资料","content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"type":"string"},"alternateName":{"type":"string"},"url":{"type":"string","format":"uri"},"logo":{"type":"string","format":"uri"},"favicon":{"type":"string","format":"uri"},"preferredAnchorText":{"type":"string"},"description":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"html":{"type":"string"}},"required":["brand","url","preferredAnchorText","description","keywords","html"]}}}}}}},"/api/public/content":{"get":{"operationId":"getPublicContentIndex","summary":"获取案例、广告邀约与新闻资讯","description":"返回找模网公开案例与方案参考、广告邀约、新闻资讯的标题、摘要、关键词、固定内容地址与相关操作地址。","responses":{"200":{"description":"公开内容结构化索引","content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"type":"string"},"canonicalUrl":{"type":"string","format":"uri"},"description":{"type":"string"},"updatedAt":{"type":"string","format":"date"},"total":{"type":"integer"},"content":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"contentType":{"type":"string","enum":["plan-reference","opportunity","news"]},"category":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"contentUrl":{"type":"string","format":"uri"},"sourceUrl":{"type":"string","format":"uri"},"pageUrl":{"type":"string","format":"uri"},"actionUrl":{"type":"string","format":"uri"}},"required":["id","contentType","category","title","summary","keywords","contentUrl","sourceUrl","pageUrl","actionUrl"]}}},"required":["brand","canonicalUrl","description","updatedAt","total","content"]}}}}}}},"/api/public/geo":{"get":{"operationId":"getGeoReadinessReport","summary":"获取GEO检测报告与配置状态","description":"返回找模网面向公开搜索和AI检索的优化目标、已生效基础能力、待授权渠道与机器可读入口。模型目标不代表厂商直连或收录保证。","responses":{"200":{"description":"GEO基础能力与配置状态","content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"type":"string"},"canonicalUrl":{"type":"string","format":"uri"},"description":{"type":"string"},"scope":{"type":"string","enum":["public-web-discovery"]},"directModelApiIntegrations":{"type":"array","items":{"type":"string"}},"disclosure":{"type":"string"},"updatedAt":{"type":"string","format":"date"},"modelOptimizationTargets":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"market":{"type":"string","enum":["国内","国际"]}},"required":["name","market"]}},"selfMediaTargets":{"type":"object","properties":{"authorizationRequired":{"type":"boolean"},"channels":{"type":"array","items":{"type":"string"}}},"required":["authorizationRequired","channels"]},"audit":{"type":"array","items":{"type":"object"}},"modules":{"type":"array","items":{"type":"object"}},"machineReadable":{"type":"object","additionalProperties":{"type":"string","format":"uri"}}},"required":["brand","canonicalUrl","scope","disclosure","updatedAt","modelOptimizationTargets","selfMediaTargets","audit","modules","machineReadable"]}}}}}}},"/api/public/models":{"get":{"operationId":"searchPublicModels","summary":"搜索公开模特","description":"为淘宝、天猫、抖音、小红书、TikTok Shop、Amazon 和 Shopify 卖家匹配真人模特。","parameters":[{"name":"q","in":"query","description":"自由搜索词，例如美妆、口播、手模","schema":{"type":"string"}},{"name":"modelId","in":"query","description":"精确 Model ID，例如 ZM00075","schema":{"type":"string"}},{"name":"city","in":"query","description":"城市或地区","schema":{"type":"string"}},{"name":"category","in":"query","description":"适合拍摄的产品品类","schema":{"type":"string"}},{"name":"shootType","in":"query","description":"可拍内容，例如短视频、口播、开箱、产品展示","schema":{"type":"string"}},{"name":"cooperationMode","in":"query","description":"合作方式，例如寄拍、到厂","schema":{"type":"string"}},{"name":"limit","in":"query","description":"返回数量，1 至 20，默认 12","schema":{"type":"integer","minimum":1,"maximum":20,"default":12}}],"responses":{"200":{"description":"公开模特搜索结果","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"description":{"type":"string"},"totalMatched":{"type":"integer"},"returned":{"type":"integer"},"requestUrl":{"type":"string","format":"uri"},"results":{"type":"array","items":{"type":"object","properties":{"modelId":{"type":"string"},"name":{"type":"string"},"city":{"type":"string"},"heightCm":{"type":"number"},"talentType":{"type":"string"},"cooperationModes":{"type":"array","items":{"type":"string"}},"suitableFor":{"type":"array","items":{"type":"string"}},"canShoot":{"type":"array","items":{"type":"string"}},"bodyParts":{"type":"array","items":{"type":"string"}},"skills":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"bio":{"type":"string"},"coverImageUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"}},"required":["modelId","name","talentType","cooperationModes","suitableFor","canShoot","profileUrl"]}}},"required":["service","description","totalMatched","returned","results","requestUrl"]}}}}}}}}}