Extract Metadata By Property Name Match Regex

This REST API allows to extract metadata properties from the document choosing the properties which names are matching the specified regular expression.

cURL example

The following example demonstrates how to extract metadata information from all properties with the “dc” string in the beginning of the name.

# First get JSON Web Token
# Please get your Client Id and Client Secret from https://dashboard.groupdocs.cloud/applications.
# The values are taken from 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": {
        "NameOptions": {
            "Value": "^dc:.*",
            "MatchOptions": {
                "IsRegex": true
            }
        }
    }
}'
# First get JSON Web Token
# Please get your Client Id and Client Secret from https://dashboard.groupdocs.cloud/applications.
# The values are taken from environment variables CLIENT_ID and CLIENT_SECRET.
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': {
        'NameOptions': {
            'Value': '^dc:.*',
            'MatchOptions': {
                'IsRegex': $true
            }
        }
    }
}"
REM First get JSON Web Token
REM Please get your Client Id and Client Secret from https://dashboard.groupdocs.cloud/applications.
REM The values are taken from 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"

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\":{\"NameOptions\":{\"Value\":\"^dc:.*\",\"MatchOptions\":{\"IsRegex\":true}}}}"
{
    "properties": [
        {
            "name": "dc:title",
            "value": "",
            "propertyType": "String",
            "tags": [
                {
                    "name": "Title",
                    "category": "Content"
                }
            ]
        },
        {
            "name": "dc:subject",
            "value": "",
            "propertyType": "String",
            "tags": [
                {
                    "name": "Subject",
                    "category": "Content"
                }
            ]
        },
        {
            "name": "dc:creator",
            "value": "Prokofjev Igor",
            "propertyType": "String",
            "tags": [
                {
                    "name": "Creator",
                    "category": "Person"
                }
            ]
        },
        {
            "name": "dc:description",
            "value": "",
            "propertyType": "String",
            "tags": [
                {
                    "name": "Description",
                    "category": "Content"
                }
            ]
        }
    ]
}

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.