Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  1. Fotoware Alto
    • 11.14 Schreckhorn
    • Terminology
    • Solutions
    • User Guide - Deutsch
    • User Guide - English
    • API Changelog
  2. Fotoware Veloz
    • Managing users and groups
    • Configuring archives
    • Configuring workflows
    • Configuring site behavior
    • Navigating and searching to find your assets
    • Working with your assets
    • Editing asset metadata
    • Uploading files
    • Version Control in Fotoware
    • Albums - Creating and sharing collections
    • Placing assets in a CMS
    • Working with the Fotoware Pro interface
    • Using the Fotoware plugins
    • Consent management
    • User guide to FotoWeb for iPad (Legacy)
    • Picture conferencing with FotoWeb Screens (Legacy)
    • What's what in Fotoware
    • GDPR
    • Fotoware Veloz releases
    • Activity Exports
    • Fotoware Example Workflows
  3. Fotostation
    • Getting started with Fotostation
    • Viewing, selecting and sorting files
    • Managing your assets with archives
    • Adding metadata to assets
    • Searching for assets
    • Working with your assets
    • Version Control in Fotostation
    • Automating tasks with Actions
    • Configuring metadata fields and editors
    • Configuring Fotostation
    • Configuring Fotostation for multi-user environments
    • Troubleshooting Fotostation
  4. Fotoware Flow
    • What is Flow?
    • Getting started
    • Flow dictionary
  5. Fotoware On-Premises
    • Getting started
    • Index Manager
    • FotoWeb
    • Color Factory
    • Connect
    • Operations Center Guide
  6. Integrations and APIs
    • The Fotoware API
    • Creating integrations using embeddable widgets
    • Authorizing applications using OAuth
    • Auto-tagging
    • FotoWeb Drag and Drop export
    • Integration using webhooks
    • Optimizely and Episerver plugin documentation
    • User Interface Integrations
  7. Fotoware Mobile
    • User guide for Fotoware Mobile for iPhone and Android
    • User guide to FotoWeb for iPad (Legacy)
    • User guide to FotoWeb for iPhone and Android (Legacy)

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Support

Table of Contents

URL Parameters Search[1] PreviewSize[*] := [ 0 . . . 1024 ] FileInfo[1] := [ 0 | 1 ] MetaData[1] := [ 0 | 1 ] Return value
  • Home
  • Fotoware On-Premises
  • FotoWeb
  • Legacy APIs (On-Premises)
  • The FotoWeb Archive Agent API (Legacy) (On-Premises)

Search method

This method executes a search through the agent and returns the resulting file list as an XML document.

29. April 2025

Elaine Foley

Table of Contents

URL Parameters Search[1] PreviewSize[*] := [ 0 . . . 1024 ] FileInfo[1] := [ 0 | 1 ] MetaData[1] := [ 0 | 1 ] Return value

Note: The Preview Agent API is deprecated and will be set to End of Life on July 1st, 2024.

If you have integrations that display previews in real-time, we recommend looking into alternative solutions such as obtaining temporary preview links from the RESTful API.

URL

http://servername/ArchiveAgentPath/Search

Parameters

Search[1]

The string to search for.

PreviewSize[*] := [ 0 . . . 1024 ]

The maximum dimension in pixels for a preview. The URL for this preview will be returned.

FileInfo[1] := [ 0 | 1 ]

Boolean value indicating if file information should be returned with the file list.

MetaData[1] := [ 0 | 1 ]

Boolean value indicating if metadata should be returned with the file list.

Return value

An ‘Archive Agent File List XML’ document containing a list of files matching the search string and any requested
data:

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

<?xml version="1.0" ?>

<FileList

Version="1.0"

CreatorApplication="FotoWeb/6.0"

Created="Mon, 06 Jun 2005 11:50:38 GMT"

Created="Mon, 06 Jun 2005 11:50:38 GMT"

ReturnedHits="2"

SearchTime="0.582941850472644"

ProcessingTime="4.4580299341163">

<File Name="182492.jpg" Id="fileIdString">

<PreviewLinks>

<PreviewUrl Id="0" Size="200">previewUrl</PreviewUrl>

</PreviewLinks>

 

<FileInfo>

<Path>D:\Media Library\Archive\Images\Alain Ernoult</Path>

<Created>Tue, 30 Sep 2003 09:23:38 GMT</Created>

<LastModified>Wed, 16 Mar 2005 12:59:15 GMT</LastModified>

<FileSize>4203447</FileSize>

<MimeType>image/jpeg</MimeType>

</FileInfo>

 

<MetaData>

<PixelWidth>3565</PixelWidth>

<PixelHeight>2371</PixelHeight>

<Resolution>300.00</Resolution>

<ColorSpace>Rgb</ColorSpace>

 

<Text>

<Field Id="IPTC2:0" Name="Iptc Field 0" />

<Field Id="IPTC2:120" Name="Caption">AUTO VOITURE</Field>

</Text>

</MetaData>

</File>

</FileList>

locate approach find technique

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Application registration using OAuth 2.0
  • Non-interactive application authorization with OAuth 2.0
  • Authorizing a client using OAuth 2.0
eco-lighthouse-miljøfyrtårn

Company

  • About us
  • Resellers
  • Careers
  • Contact us

Help & support

  • Support center
  • Consultancy
  • Tech partners
  • Fotostation
  • System status

Trust Center

  • Legal
  • Security
  • Sustainability & ESG

Locations

Fotoware AS (HQ)
Tollbugata 35
0157 OSLO
Norway
FotoWare Switzerland AG
Industriestrasse 25
5033 Buchs (AG)
Switzerland

Copyright 2025 Fotoware All rights reserved.

  • Terms of service
  • Privacy policy
  • Cookie policy

Knowledge Base Software powered by Helpjuice

Expand