Extract Metadata By Tag

This REST API allows to extract metadata properties from the document choosing the properties by exact tag and category name.

cURL example

The following example demonstrates how to extract metadata information from all properties with Created tag.

# Get JSON Web Token
# Provide your Client Id and Client Secret via environment variables CLIENT_ID and CLIENT_SECRET.
curl -v "https://api.groupdocs.cloud/connect/token" \
  -X POST \
  -d "grant_type=client_credentials&client_id=$CLIENT_ID&client_secret=$CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Accept: application/json"

# cURL example to join several documents into one
curl -v "https://api.groupdocs.cloud/v1.0/metadata" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $JWT_TOKEN" \
  -d '{
    "FileInfo": {
        "FilePath": "documents/input.docx",
        "StorageName": ""
    },
    "SearchCriteria": {
        "TagOptions": {
            "ExactTag": {
                "Name": "Created",
                "Category": "Time"
            }
        }
    }
}'
# Get JSON Web Token
# Provide your Client Id and Client Secret via environment variables.
curl.exe -v "https://api.groupdocs.cloud/connect/token" `
  -X POST `
  -d "grant_type=client_credentials&client_id=$env:CLIENT_ID&client_secret=$env:CLIENT_SECRET" `
  -H "Content-Type: application/x-www-form-urlencoded" `
  -H "Accept: application/json"

# cURL example to join several documents into one
curl.exe -v "https://api.groupdocs.cloud/v1.0/metadata" `
  -X POST `
  -H "Content-Type: application/json" `
  -H "Accept: application/json" `
  -H "Authorization: Bearer $env:JWT_TOKEN" `
  -d "{
    'FileInfo': {
        'FilePath': 'documents\\input.docx',
        'StorageName': ''
    },
    'SearchCriteria': {
        'TagOptions': {
            'ExactTag': {
                'Name': 'Created',
                'Category': 'Time'
            }
        }
    }
}"
rem Get JSON Web Token
rem Provide your Client Id and Client Secret via environment variables.
curl -v "https://api.groupdocs.cloud/connect/token" ^
  -X POST ^
  -d "grant_type=client_credentials&client_id=%CLIENT_ID%&client_secret=%CLIENT_SECRET%" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -H "Accept: application/json"

rem cURL example to join several documents into one
curl -v "https://api.groupdocs.cloud/v1.0/metadata" ^
  -X POST ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json" ^
  -H "Authorization: Bearer %JWT_TOKEN%" ^
  -d "{\"FileInfo\":{\"FilePath\":\"documents\\input.docx\",\"StorageName\":\"\"},\"SearchCriteria\":{\"TagOptions\":{\"ExactTag\":{\"Name\":\"Created\",\"Category\":\"Time\"}}}}"
{
    "properties": [
        {
            "name": "CreateTime",
            "value": "03/22/2016 17:08:00",
            "propertyType": "DateTime",
            "tags": [
                {
                    "name": "Created",
                    "category": "Time"
                },
                {
                    "name": "PropertyTypeBuiltIn",
                    "category": "Document"
                }
            ]
        }
    ]
}

SDK examples

Using an SDK (API client) is the quickest way for a developer to speed up the development. An SDK takes care of a lot of low-level details of making requests and handling responses and lets you focus on writing code specific to your particular project. Check out our GitHub repository for a complete list of GroupDocs.Metadata Cloud SDKs along with working examples, to get you started in no time. Please check Available SDKs article to learn how to add an SDK to your project.