[{"data":1,"prerenderedAt":996},["ShallowReactive",2],{"navigation_docs_en":3,"-en-media-overview":179,"-en-media-overview-surround":991},[4,36,57,87,107,127,143,154,162],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":35},"Getting Started","i-lucide-rocket","/en/getting-started","en/1.getting-started",[10,15,20,25,30],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","/en/getting-started/introduction","en/1.getting-started/1.introduction","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"Agency Setup","/en/getting-started/agency-setup","en/1.getting-started/2.agency-setup","i-lucide-building-2",{"title":21,"path":22,"stem":23,"icon":24},"Authentication","/en/getting-started/authentication","en/1.getting-started/3.authentication","i-lucide-key",{"title":26,"path":27,"stem":28,"icon":29},"Quick Start","/en/getting-started/quick-start","en/1.getting-started/4.quick-start","i-lucide-zap",{"title":31,"path":32,"stem":33,"icon":34},"Postman Collection","/en/getting-started/postman","en/1.getting-started/5.postman","i-lucide-download",false,{"title":37,"icon":38,"path":39,"stem":40,"children":41,"page":35},"Concepts","i-lucide-lightbulb","/en/concepts","en/2.concepts",[42,47,52],{"title":43,"path":44,"stem":45,"icon":46},"External ID","/en/concepts/external-ids","en/2.concepts/1.external-ids","i-lucide-link",{"title":48,"path":49,"stem":50,"icon":51},"Upsert Pattern","/en/concepts/upsert-pattern","en/2.concepts/2.upsert-pattern","i-lucide-refresh-cw",{"title":53,"path":54,"stem":55,"icon":56},"Async Jobs","/en/concepts/async-jobs","en/2.concepts/3.async-jobs","i-lucide-clock",{"title":58,"icon":59,"path":60,"stem":61,"children":62,"page":35},"Listings","i-lucide-home","/en/listings","en/3.listings",[63,68,73,78,83],{"title":64,"path":65,"stem":66,"icon":67},"Listings Overview","/en/listings/overview","en/3.listings/1.overview","i-lucide-layout-list",{"title":69,"path":70,"stem":71,"icon":72},"Create and Update","/en/listings/create-update","en/3.listings/2.create-update","i-lucide-plus",{"title":74,"path":75,"stem":76,"icon":77},"Retrieve Listings","/en/listings/retrieve","en/3.listings/3.retrieve","i-lucide-search",{"title":79,"path":80,"stem":81,"icon":82},"Bulk Operations","/en/listings/bulk","en/3.listings/4.bulk","i-lucide-layers",{"title":84,"path":85,"stem":86,"icon":46},"External ID Linking","/en/listings/external-id-linking","en/3.listings/5.external-id-linking",{"title":88,"icon":89,"path":90,"stem":91,"children":92,"page":35},"Users","i-lucide-users","/en/users","en/4.users",[93,98,103],{"title":94,"path":95,"stem":96,"icon":97},"Users Overview","/en/users/overview","en/4.users/1.overview","i-lucide-user",{"title":99,"path":100,"stem":101,"icon":102},"Update Profile","/en/users/update","en/4.users/2.update","i-lucide-user-pen",{"title":104,"path":105,"stem":106,"icon":77},"Retrieve Users","/en/users/retrieve","en/4.users/3.retrieve",{"title":108,"icon":109,"path":110,"stem":111,"children":112,"page":35},"Media","i-lucide-image","/en/media","en/5.media",[113,117,122],{"title":114,"path":115,"stem":116,"icon":109},"Media Overview","/en/media/overview","en/5.media/1.overview",{"title":118,"path":119,"stem":120,"icon":121},"Upload Files","/en/media/upload","en/5.media/2.upload","i-lucide-upload",{"title":123,"path":124,"stem":125,"icon":126},"Manage Files","/en/media/manage","en/5.media/3.manage","i-lucide-folder",{"title":128,"icon":129,"path":130,"stem":131,"children":132,"page":35},"Reference","i-lucide-book-open","/en/reference","en/6.reference",[133,138],{"title":134,"path":135,"stem":136,"icon":137},"Field Schema","/en/reference/schema","en/6.reference/1.schema","i-lucide-file-json",{"title":139,"path":140,"stem":141,"icon":142},"Currencies and Rates","/en/reference/currencies","en/6.reference/2.currencies","i-lucide-wallet",{"title":144,"icon":145,"path":146,"stem":147,"children":148,"page":35},"Errors","i-lucide-alert-triangle","/en/errors","en/7.errors",[149],{"title":150,"path":151,"stem":152,"icon":153},"Error Handling","/en/errors/error-handling","en/7.errors/1.error-handling","i-lucide-shield-alert",{"title":155,"path":156,"stem":157,"children":158,"icon":161},"Changelog","/en/changelog","en/8.changelog/1.index",[159],{"title":155,"path":156,"stem":157,"icon":160},"i-lucide-scroll-text","i-lucide-history",{"title":163,"path":164,"stem":165,"children":166,"page":35},"Guides","/en/guides","en/9.guides",[167,171,175],{"title":168,"path":169,"stem":170,"icon":129},"Integration Guides","/en/guides/overview","en/9.guides/1.overview",{"title":172,"path":173,"stem":174,"icon":121},"Initial Sync","/en/guides/first-sync","en/9.guides/2.first-sync",{"title":176,"path":177,"stem":178,"icon":51},"Continuous Sync","/en/guides/continuous-sync","en/9.guides/3.continuous-sync",{"id":180,"title":114,"body":181,"description":984,"extension":985,"links":986,"meta":987,"navigation":988,"path":115,"seo":989,"stem":116,"__hash__":990},"docs_en/en/5.media/1.overview.md",{"type":182,"value":183,"toc":972},"minimark",[184,188,192,197,261,267,271,276,279,283,286,290,336,340,345,356,361,367,371,374,727,794,798,948,952,968],[185,186,187],"p",{},"Media files are a required part of listings. You need at least 3 photos for publishing. The API supports two upload methods and automatically optimizes all files.",[189,190,191],"note",{},"You don't need to optimize photos before uploading — upload originals.",[193,194,196],"h2",{"id":195},"upload-methods","Upload Methods",[198,199,200,216],"table",{},[201,202,203],"thead",{},[204,205,206,210,213],"tr",{},[207,208,209],"th",{},"Method",[207,211,212],{},"When to Use",[207,214,215],{},"Description",[217,218,219,234,248],"tbody",{},[204,220,221,228,231],{},[222,223,224],"td",{},[225,226,227],"strong",{},"URL in listing",[222,229,230],{},"Whenever possible",[222,232,233],{},"Simplest — pass URLs directly when creating a listing",[204,235,236,242,245],{},[222,237,238],{},[239,240,241],"a",{"href":119},"Import by URL",[222,243,244],{},"Pre-upload",[222,246,247],{},"Upload photos separately, then link to listing",[204,249,250,255,258],{},[222,251,252],{},[239,253,254],{"href":119},"Signed URL",[222,256,257],{},"Upload from local disk",[222,259,260],{},"For files without a public URL",[185,262,263,266],{},[225,264,265],{},"Recommendation:"," Pass photo URLs directly when creating a listing — the system will download them automatically. This is the simplest approach.",[193,268,270],{"id":269},"supported-formats","Supported Formats",[272,273,275],"h3",{"id":274},"images","Images",[185,277,278],{},"JPEG, PNG, WebP, HEIC, and other popular formats.",[272,280,282],{"id":281},"video","Video",[185,284,285],{},"MP4, AVI, MOV — up to 3 minutes.",[193,287,289],{"id":288},"limits","Limits",[198,291,292,302],{},[201,293,294],{},[204,295,296,299],{},[207,297,298],{},"Parameter",[207,300,301],{},"Value",[217,303,304,312,320,328],{},[204,305,306,309],{},[222,307,308],{},"Minimum photos for publishing",[222,310,311],{},"3",[204,313,314,317],{},[222,315,316],{},"Maximum photos per listing",[222,318,319],{},"20",[204,321,322,325],{},[222,323,324],{},"Files in a single request",[222,326,327],{},"up to 100",[204,329,330,333],{},[222,331,332],{},"Signed URL validity",[222,334,335],{},"30 minutes",[193,337,339],{"id":338},"typical-scenario","Typical Scenario",[185,341,342],{},[225,343,344],{},"Recommended approach — in one request:",[346,347,352],"pre",{"className":348,"code":350,"language":351},[349],"language-text","PUT /listings\n→ pass files: [{ url: \"https://...\" }] and announcementStatus: \"active\"\n→ system automatically downloads and optimizes photos\n","text",[353,354,350],"code",{"__ignoreMap":355},"",[185,357,358],{},[225,359,360],{},"Alternative approach — separate upload:",[346,362,365],{"className":363,"code":364,"language":351},[349],"1. Upload photos → POST /media/bulk\n   → with upload-from-url operation\n\n2. Link to listing → PUT /listings\n   → pass files: [{ id: 123 }] or [{ externalFileId: \"...\" }]\n",[353,366,364],{"__ignoreMap":355},[193,368,370],{"id":369},"media-file-structure","Media File Structure",[185,372,373],{},"After upload and optimization, a file contains:",[346,375,379],{"className":376,"code":377,"language":378,"meta":355,"style":355},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"id\": 123,\n  \"externalId\": \"photo-001\",\n  \"size\": 245000,\n  \"contentType\": \"image/jpeg\",\n  \"optimization\": \"success\",\n  \"blurhash\": \"L7HuX^zY1z-6ADx?0z2@1Io#{yV_\",\n  \"originalUrl\": \"https://storage.../original.jpg\",\n  \"variants\": [\n    { \"url\": \"https://storage.../128.webp\", \"variantSize\": \"128\", \"size\": 4074 },\n    { \"url\": \"https://storage.../512.webp\", \"variantSize\": \"512\", \"size\": 32850 },\n    { \"url\": \"https://storage.../1024.webp\", \"variantSize\": \"1024\", \"size\": 98500 }\n  ]\n}\n","json",[353,380,381,390,413,436,453,474,495,516,537,552,610,662,715,721],{"__ignoreMap":355},[382,383,386],"span",{"class":384,"line":385},"line",1,[382,387,389],{"class":388},"sMK4o","{\n",[382,391,393,396,400,403,406,410],{"class":384,"line":392},2,[382,394,395],{"class":388},"  \"",[382,397,399],{"class":398},"spNyl","id",[382,401,402],{"class":388},"\"",[382,404,405],{"class":388},":",[382,407,409],{"class":408},"sbssI"," 123",[382,411,412],{"class":388},",\n",[382,414,416,418,421,423,425,428,432,434],{"class":384,"line":415},3,[382,417,395],{"class":388},[382,419,420],{"class":398},"externalId",[382,422,402],{"class":388},[382,424,405],{"class":388},[382,426,427],{"class":388}," \"",[382,429,431],{"class":430},"sfazB","photo-001",[382,433,402],{"class":388},[382,435,412],{"class":388},[382,437,439,441,444,446,448,451],{"class":384,"line":438},4,[382,440,395],{"class":388},[382,442,443],{"class":398},"size",[382,445,402],{"class":388},[382,447,405],{"class":388},[382,449,450],{"class":408}," 245000",[382,452,412],{"class":388},[382,454,456,458,461,463,465,467,470,472],{"class":384,"line":455},5,[382,457,395],{"class":388},[382,459,460],{"class":398},"contentType",[382,462,402],{"class":388},[382,464,405],{"class":388},[382,466,427],{"class":388},[382,468,469],{"class":430},"image/jpeg",[382,471,402],{"class":388},[382,473,412],{"class":388},[382,475,477,479,482,484,486,488,491,493],{"class":384,"line":476},6,[382,478,395],{"class":388},[382,480,481],{"class":398},"optimization",[382,483,402],{"class":388},[382,485,405],{"class":388},[382,487,427],{"class":388},[382,489,490],{"class":430},"success",[382,492,402],{"class":388},[382,494,412],{"class":388},[382,496,498,500,503,505,507,509,512,514],{"class":384,"line":497},7,[382,499,395],{"class":388},[382,501,502],{"class":398},"blurhash",[382,504,402],{"class":388},[382,506,405],{"class":388},[382,508,427],{"class":388},[382,510,511],{"class":430},"L7HuX^zY1z-6ADx?0z2@1Io#{yV_",[382,513,402],{"class":388},[382,515,412],{"class":388},[382,517,519,521,524,526,528,530,533,535],{"class":384,"line":518},8,[382,520,395],{"class":388},[382,522,523],{"class":398},"originalUrl",[382,525,402],{"class":388},[382,527,405],{"class":388},[382,529,427],{"class":388},[382,531,532],{"class":430},"https://storage.../original.jpg",[382,534,402],{"class":388},[382,536,412],{"class":388},[382,538,540,542,545,547,549],{"class":384,"line":539},9,[382,541,395],{"class":388},[382,543,544],{"class":398},"variants",[382,546,402],{"class":388},[382,548,405],{"class":388},[382,550,551],{"class":388}," [\n",[382,553,555,558,560,564,566,568,570,573,575,578,580,583,585,587,589,592,594,596,598,600,602,604,607],{"class":384,"line":554},10,[382,556,557],{"class":388},"    {",[382,559,427],{"class":388},[382,561,563],{"class":562},"sBMFI","url",[382,565,402],{"class":388},[382,567,405],{"class":388},[382,569,427],{"class":388},[382,571,572],{"class":430},"https://storage.../128.webp",[382,574,402],{"class":388},[382,576,577],{"class":388},",",[382,579,427],{"class":388},[382,581,582],{"class":562},"variantSize",[382,584,402],{"class":388},[382,586,405],{"class":388},[382,588,427],{"class":388},[382,590,591],{"class":430},"128",[382,593,402],{"class":388},[382,595,577],{"class":388},[382,597,427],{"class":388},[382,599,443],{"class":562},[382,601,402],{"class":388},[382,603,405],{"class":388},[382,605,606],{"class":408}," 4074",[382,608,609],{"class":388}," },\n",[382,611,613,615,617,619,621,623,625,628,630,632,634,636,638,640,642,645,647,649,651,653,655,657,660],{"class":384,"line":612},11,[382,614,557],{"class":388},[382,616,427],{"class":388},[382,618,563],{"class":562},[382,620,402],{"class":388},[382,622,405],{"class":388},[382,624,427],{"class":388},[382,626,627],{"class":430},"https://storage.../512.webp",[382,629,402],{"class":388},[382,631,577],{"class":388},[382,633,427],{"class":388},[382,635,582],{"class":562},[382,637,402],{"class":388},[382,639,405],{"class":388},[382,641,427],{"class":388},[382,643,644],{"class":430},"512",[382,646,402],{"class":388},[382,648,577],{"class":388},[382,650,427],{"class":388},[382,652,443],{"class":562},[382,654,402],{"class":388},[382,656,405],{"class":388},[382,658,659],{"class":408}," 32850",[382,661,609],{"class":388},[382,663,665,667,669,671,673,675,677,680,682,684,686,688,690,692,694,697,699,701,703,705,707,709,712],{"class":384,"line":664},12,[382,666,557],{"class":388},[382,668,427],{"class":388},[382,670,563],{"class":562},[382,672,402],{"class":388},[382,674,405],{"class":388},[382,676,427],{"class":388},[382,678,679],{"class":430},"https://storage.../1024.webp",[382,681,402],{"class":388},[382,683,577],{"class":388},[382,685,427],{"class":388},[382,687,582],{"class":562},[382,689,402],{"class":388},[382,691,405],{"class":388},[382,693,427],{"class":388},[382,695,696],{"class":430},"1024",[382,698,402],{"class":388},[382,700,577],{"class":388},[382,702,427],{"class":388},[382,704,443],{"class":562},[382,706,402],{"class":388},[382,708,405],{"class":388},[382,710,711],{"class":408}," 98500",[382,713,714],{"class":388}," }\n",[382,716,718],{"class":384,"line":717},13,[382,719,720],{"class":388},"  ]\n",[382,722,724],{"class":384,"line":723},14,[382,725,726],{"class":388},"}\n",[198,728,729,738],{},[201,730,731],{},[204,732,733,736],{},[207,734,735],{},"Field",[207,737,215],{},[217,739,740,749,758,767,776,785],{},[204,741,742,746],{},[222,743,744],{},[353,745,399],{},[222,747,748],{},"Internal file ID",[204,750,751,755],{},[222,752,753],{},[353,754,420],{},[222,756,757],{},"Your CRM ID",[204,759,760,764],{},[222,761,762],{},[353,763,481],{},[222,765,766],{},"Optimization status",[204,768,769,773],{},[222,770,771],{},[353,772,502],{},[222,774,775],{},"String for generating placeholder",[204,777,778,782],{},[222,779,780],{},[353,781,523],{},[222,783,784],{},"Link to original",[204,786,787,791],{},[222,788,789],{},[353,790,544],{},[222,792,793],{},"Optimized versions of different sizes",[193,795,797],{"id":796},"api-endpoints","API Endpoints",[198,799,800,811],{},[201,801,802],{},[204,803,804,806,809],{},[207,805,209],{},[207,807,808],{},"Path",[207,810,215],{},[217,812,813,829,846,861,878,892,908,921,935],{},[204,814,815,820,825],{},[222,816,817],{},[353,818,819],{},"POST",[222,821,822],{},[353,823,824],{},"/media/upload-from-url",[222,826,827],{},[239,828,241],{"href":119},[204,830,831,835,840],{},[222,832,833],{},[353,834,819],{},[222,836,837],{},[353,838,839],{},"/media/bulk",[222,841,842,845],{},[239,843,844],{"href":119},"Bulk operations"," (upload-from-url, confirm-upload, etc.)",[204,847,848,852,857],{},[222,849,850],{},[353,851,819],{},[222,853,854],{},[353,855,856],{},"/media/request-upload-url",[222,858,859],{},[239,860,254],{"href":119},[204,862,863,868,873],{},[222,864,865],{},[353,866,867],{},"GET",[222,869,870],{},[353,871,872],{},"/media/:id",[222,874,875],{},[239,876,877],{"href":124},"Get file",[204,879,880,884,889],{},[222,881,882],{},[353,883,867],{},[222,885,886],{},[353,887,888],{},"/media/external/:externalId",[222,890,891],{},"Get by external ID",[204,893,894,899,903],{},[222,895,896],{},[353,897,898],{},"DELETE",[222,900,901],{},[353,902,872],{},[222,904,905],{},[239,906,907],{"href":124},"Delete file",[204,909,910,914,918],{},[222,911,912],{},[353,913,898],{},[222,915,916],{},[353,917,888],{},[222,919,920],{},"Delete by external ID",[204,922,923,927,932],{},[222,924,925],{},[353,926,819],{},[222,928,929],{},[353,930,931],{},"/media/:id/link",[222,933,934],{},"Link external ID",[204,936,937,941,945],{},[222,938,939],{},[353,940,898],{},[222,942,943],{},[353,944,931],{},[222,946,947],{},"Unlink external ID",[193,949,951],{"id":950},"next-steps","Next Steps",[953,954,955,962],"ul",{},[956,957,958,961],"li",{},[239,959,960],{"href":119},"Upload photos"," — step-by-step instructions",[956,963,964,967],{},[239,965,966],{"href":124},"Manage files"," — retrieval, deletion, linking",[969,970,971],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":355,"searchDepth":392,"depth":392,"links":973},[974,975,979,980,981,982,983],{"id":195,"depth":392,"text":196},{"id":269,"depth":392,"text":270,"children":976},[977,978],{"id":274,"depth":415,"text":275},{"id":281,"depth":415,"text":282},{"id":288,"depth":392,"text":289},{"id":338,"depth":392,"text":339},{"id":369,"depth":392,"text":370},{"id":796,"depth":392,"text":797},{"id":950,"depth":392,"text":951},"Uploading photos and videos for listings via API","md",null,{},{"icon":109},{"title":114,"description":984},"Z8gXpR0O63BshL-pJ7F7LqQniecSDRwrmVWFFsvj0m0",[992,994],{"title":104,"path":105,"stem":106,"description":993,"icon":77,"children":-1},"Finding agents and linking external IDs",{"title":118,"path":119,"stem":120,"description":995,"icon":121,"children":-1},"How to upload photos — via URL in listing, import by URL, or signed URL",1773784448626]