2025/07/24 - Amazon DataZone - 2 updated api methods
Changes This release adds support for 1) highlighting relevant text in returned results for Search and SearchListings APIs and 2) returning aggregated counts of values for specified attributes for SearchListings API.
{'additionalAttributes': {'TEXT_MATCH_RATIONALE'}}
Response {'items': {'assetItem': {'additionalAttributes': {'matchRationale': [{'textMatches': [{'attribute': 'string',
'matchOffsets': [{'endOffset': 'integer',
'startOffset': 'integer'}],
'text': 'string'}]}]}},
'dataProductItem': {'additionalAttributes': {'matchRationale': [{'textMatches': [{'attribute': 'string',
'matchOffsets': [{'endOffset': 'integer',
'startOffset': 'integer'}],
'text': 'string'}]}]}},
'glossaryItem': {'additionalAttributes': {'matchRationale': [{'textMatches': [{'attribute': 'string',
'matchOffsets': [{'endOffset': 'integer',
'startOffset': 'integer'}],
'text': 'string'}]}]}},
'glossaryTermItem': {'additionalAttributes': {'matchRationale': [{'textMatches': [{'attribute': 'string',
'matchOffsets': [{'endOffset': 'integer',
'startOffset': 'integer'}],
'text': 'string'}]}]}}}}
Searches for assets in Amazon DataZone.
See also: AWS API Documentation
Request Syntax
client.search(
additionalAttributes=[
'FORMS'|'TIME_SERIES_DATA_POINT_FORMS'|'TEXT_MATCH_RATIONALE',
],
domainIdentifier='string',
filters={
'and': [
{'... recursive ...'},
],
'filter': {
'attribute': 'string',
'value': 'string'
},
'or': [
{'... recursive ...'},
]
},
maxResults=123,
nextToken='string',
owningProjectIdentifier='string',
searchIn=[
{
'attribute': 'string'
},
],
searchScope='ASSET'|'GLOSSARY'|'GLOSSARY_TERM'|'DATA_PRODUCT',
searchText='string',
sort={
'attribute': 'string',
'order': 'ASCENDING'|'DESCENDING'
}
)
list
Specifies additional attributes for the Search action.
(string) --
string
[REQUIRED]
The identifier of the Amazon DataZone domain.
dict
Specifies the search filters.
and (list) --
The 'and' search filter clause in Amazon DataZone.
(dict) --
A search filter clause in Amazon DataZone.
filter (dict) --
A search filter in Amazon DataZone.
attribute (string) -- [REQUIRED]
A search filter attribute in Amazon DataZone.
value (string) -- [REQUIRED]
A search filter value in Amazon DataZone.
or (list) --
The 'or' search filter clause in Amazon DataZone.
(dict) --
A search filter clause in Amazon DataZone.
integer
The maximum number of results to return in a single call to Search. When the number of results to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to Search to list the next set of results.
string
When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to Search to list the next set of results.
string
The identifier of the owning project specified for the search.
list
The details of the search.
(dict) --
The details of the search.
attribute (string) -- [REQUIRED]
The search attribute.
string
[REQUIRED]
The scope of the search.
string
Specifies the text for which to search.
dict
Specifies the way in which the search results are to be sorted.
attribute (string) -- [REQUIRED]
The attribute detail of the way to sort search results.
order (string) --
The order detail of the wya to sort search results.
dict
Response Syntax
{
'items': [
{
'assetItem': {
'additionalAttributes': {
'formsOutput': [
{
'content': 'string',
'formName': 'string',
'typeName': 'string',
'typeRevision': 'string'
},
],
'latestTimeSeriesDataPointFormsOutput': [
{
'contentSummary': 'string',
'formName': 'string',
'id': 'string',
'timestamp': datetime(2015, 1, 1),
'typeIdentifier': 'string',
'typeRevision': 'string'
},
],
'matchRationale': [
{
'textMatches': [
{
'attribute': 'string',
'matchOffsets': [
{
'endOffset': 123,
'startOffset': 123
},
],
'text': 'string'
},
]
},
],
'readOnlyFormsOutput': [
{
'content': 'string',
'formName': 'string',
'typeName': 'string',
'typeRevision': 'string'
},
]
},
'createdAt': datetime(2015, 1, 1),
'createdBy': 'string',
'description': 'string',
'domainId': 'string',
'externalIdentifier': 'string',
'firstRevisionCreatedAt': datetime(2015, 1, 1),
'firstRevisionCreatedBy': 'string',
'glossaryTerms': [
'string',
],
'identifier': 'string',
'name': 'string',
'owningProjectId': 'string',
'typeIdentifier': 'string',
'typeRevision': 'string'
},
'dataProductItem': {
'additionalAttributes': {
'matchRationale': [
{
'textMatches': [
{
'attribute': 'string',
'matchOffsets': [
{
'endOffset': 123,
'startOffset': 123
},
],
'text': 'string'
},
]
},
]
},
'createdAt': datetime(2015, 1, 1),
'createdBy': 'string',
'description': 'string',
'domainId': 'string',
'firstRevisionCreatedAt': datetime(2015, 1, 1),
'firstRevisionCreatedBy': 'string',
'glossaryTerms': [
'string',
],
'id': 'string',
'name': 'string',
'owningProjectId': 'string'
},
'glossaryItem': {
'additionalAttributes': {
'matchRationale': [
{
'textMatches': [
{
'attribute': 'string',
'matchOffsets': [
{
'endOffset': 123,
'startOffset': 123
},
],
'text': 'string'
},
]
},
]
},
'createdAt': datetime(2015, 1, 1),
'createdBy': 'string',
'description': 'string',
'domainId': 'string',
'id': 'string',
'name': 'string',
'owningProjectId': 'string',
'status': 'DISABLED'|'ENABLED',
'updatedAt': datetime(2015, 1, 1),
'updatedBy': 'string'
},
'glossaryTermItem': {
'additionalAttributes': {
'matchRationale': [
{
'textMatches': [
{
'attribute': 'string',
'matchOffsets': [
{
'endOffset': 123,
'startOffset': 123
},
],
'text': 'string'
},
]
},
]
},
'createdAt': datetime(2015, 1, 1),
'createdBy': 'string',
'domainId': 'string',
'glossaryId': 'string',
'id': 'string',
'longDescription': 'string',
'name': 'string',
'shortDescription': 'string',
'status': 'ENABLED'|'DISABLED',
'termRelations': {
'classifies': [
'string',
],
'isA': [
'string',
]
},
'updatedAt': datetime(2015, 1, 1),
'updatedBy': 'string'
}
},
],
'nextToken': 'string',
'totalMatchCount': 123
}
Response Structure
(dict) --
items (list) --
The results of the Search action.
(dict) --
The details of the search results.
assetItem (dict) --
The asset item included in the search results.
additionalAttributes (dict) --
The additional attributes of a Amazon DataZone inventory asset.
formsOutput (list) --
The forms included in the additional attributes of an inventory asset.
(dict) --
The details of a metadata form.
content (string) --
The content of the metadata form.
formName (string) --
The name of the metadata form.
typeName (string) --
The name of the metadata form type.
typeRevision (string) --
The revision of the metadata form type.
latestTimeSeriesDataPointFormsOutput (list) --
The latest time series data points forms included in the additional attributes of an asset.
(dict) --
The summary of the time series data points form.
contentSummary (string) --
The content of the summary of the time series data points form.
formName (string) --
The name of the time series data points summary form.
id (string) --
The ID of the time series data points summary form.
timestamp (datetime) --
The timestamp of the time series data points summary form.
typeIdentifier (string) --
The type ID of the time series data points summary form.
typeRevision (string) --
The type revision of the time series data points summary form.
matchRationale (list) --
List of rationales indicating why this item was matched by search.
(dict) --
A rationale indicating why this item was matched by search.
textMatches (list) --
A list of TextMatchItems.
(dict) --
A structure indicating matched terms for an attribute.
attribute (string) --
The name of the attribute.
matchOffsets (list) --
List of offsets indicating matching terms in the TextMatchItem text.
(dict) --
The offset of a matched term.
endOffset (integer) --
The 0-indexed number indicating the end position (exclusive) of a matched term.
startOffset (integer) --
The 0-indexed number indicating the start position (inclusive) of a matched term.
text (string) --
Snippet of attribute text containing highlighted content.
readOnlyFormsOutput (list) --
The read-only forms included in the additional attributes of an inventory asset.
(dict) --
The details of a metadata form.
content (string) --
The content of the metadata form.
formName (string) --
The name of the metadata form.
typeName (string) --
The name of the metadata form type.
typeRevision (string) --
The revision of the metadata form type.
createdAt (datetime) --
The timestamp of when the Amazon DataZone inventory asset was created.
createdBy (string) --
The Amazon DataZone user who created the inventory asset.
description (string) --
The description of an Amazon DataZone inventory asset.
domainId (string) --
The identifier of the Amazon DataZone domain in which the inventory asset exists.
externalIdentifier (string) --
The external identifier of the Amazon DataZone inventory asset.
firstRevisionCreatedAt (datetime) --
The timestamp of when the first revision of the inventory asset was created.
firstRevisionCreatedBy (string) --
The Amazon DataZone user who created the first revision of the inventory asset.
glossaryTerms (list) --
The glossary terms attached to the Amazon DataZone inventory asset.
(string) --
identifier (string) --
the identifier of the Amazon DataZone inventory asset.
name (string) --
The name of the Amazon DataZone inventory asset.
owningProjectId (string) --
The identifier of the Amazon DataZone project that owns the inventory asset.
typeIdentifier (string) --
The identifier of the asset type of the specified Amazon DataZone inventory asset.
typeRevision (string) --
The revision of the inventory asset type.
dataProductItem (dict) --
The data product.
additionalAttributes (dict) --
The additional attributes of an Amazon DataZone data product.
matchRationale (list) --
List of rationales indicating why this item was matched by search.
(dict) --
A rationale indicating why this item was matched by search.
textMatches (list) --
A list of TextMatchItems.
(dict) --
A structure indicating matched terms for an attribute.
attribute (string) --
The name of the attribute.
matchOffsets (list) --
List of offsets indicating matching terms in the TextMatchItem text.
(dict) --
The offset of a matched term.
endOffset (integer) --
The 0-indexed number indicating the end position (exclusive) of a matched term.
startOffset (integer) --
The 0-indexed number indicating the start position (inclusive) of a matched term.
text (string) --
Snippet of attribute text containing highlighted content.
createdAt (datetime) --
The timestamp at which the data product was created.
createdBy (string) --
The user who created the data product.
description (string) --
The description of the data product.
domainId (string) --
The ID of the domain where the data product lives.
firstRevisionCreatedAt (datetime) --
The timestamp at which first revision of the data product was created.
firstRevisionCreatedBy (string) --
The user who created the first revision of the data product.
glossaryTerms (list) --
The glossary terms of the data product.
(string) --
id (string) --
The ID of the data product.
name (string) --
The name of the data product.
owningProjectId (string) --
The ID of the owning project of the data product.
glossaryItem (dict) --
The glossary item included in the search results.
additionalAttributes (dict) --
The additional attributes of an Amazon DataZone glossary.
matchRationale (list) --
List of rationales indicating why this item was matched by search.
(dict) --
A rationale indicating why this item was matched by search.
textMatches (list) --
A list of TextMatchItems.
(dict) --
A structure indicating matched terms for an attribute.
attribute (string) --
The name of the attribute.
matchOffsets (list) --
List of offsets indicating matching terms in the TextMatchItem text.
(dict) --
The offset of a matched term.
endOffset (integer) --
The 0-indexed number indicating the end position (exclusive) of a matched term.
startOffset (integer) --
The 0-indexed number indicating the start position (inclusive) of a matched term.
text (string) --
Snippet of attribute text containing highlighted content.
createdAt (datetime) --
The timestamp of when the glossary was created.
createdBy (string) --
The Amazon DataZone user who created the glossary.
description (string) --
The business glossary description.
domainId (string) --
The identifier of the Amazon DataZone domain in which the business glossary exists.
id (string) --
The identifier of the glossary.
name (string) --
The name of the glossary.
owningProjectId (string) --
The identifier of the project that owns the business glosary.
status (string) --
The business glossary status.
updatedAt (datetime) --
The timestamp of when the business glossary was updated.
updatedBy (string) --
The Amazon DataZone user who updated the business glossary.
glossaryTermItem (dict) --
The glossary term item included in the search results.
additionalAttributes (dict) --
The additional attributes of an Amazon DataZone glossary term.
matchRationale (list) --
List of rationales indicating why this item was matched by search.
(dict) --
A rationale indicating why this item was matched by search.
textMatches (list) --
A list of TextMatchItems.
(dict) --
A structure indicating matched terms for an attribute.
attribute (string) --
The name of the attribute.
matchOffsets (list) --
List of offsets indicating matching terms in the TextMatchItem text.
(dict) --
The offset of a matched term.
endOffset (integer) --
The 0-indexed number indicating the end position (exclusive) of a matched term.
startOffset (integer) --
The 0-indexed number indicating the start position (inclusive) of a matched term.
text (string) --
Snippet of attribute text containing highlighted content.
createdAt (datetime) --
The timestamp of when a business glossary term was created.
createdBy (string) --
The Amazon DataZone user who created the business glossary.
domainId (string) --
The identifier of the Amazon DataZone domain in which the business glossary exists.
glossaryId (string) --
The identifier of the business glossary to which the term belongs.
id (string) --
The identifier of the business glossary term.
longDescription (string) --
The long description of the business glossary term.
name (string) --
The name of the business glossary term.
shortDescription (string) --
The short description of the business glossary term.
status (string) --
The status of the business glossary term.
termRelations (dict) --
The relations of the business glossary term.
classifies (list) --
The classifies of the term relations.
(string) --
isA (list) --
The isA property of the term relations.
(string) --
updatedAt (datetime) --
The timestamp of when a business glossary term was updated.
updatedBy (string) --
The Amazon DataZone user who updated the business glossary term.
nextToken (string) --
When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to Search to list the next set of results.
totalMatchCount (integer) --
Total number of search results.
{'additionalAttributes': {'TEXT_MATCH_RATIONALE'},
'aggregations': [{'attribute': 'string', 'displayValue': 'string'}]}
Response {'aggregates': [{'attribute': 'string',
'displayValue': 'string',
'items': [{'count': 'integer',
'displayValue': 'string',
'value': 'string'}]}],
'items': {'assetListing': {'additionalAttributes': {'matchRationale': [{'textMatches': [{'attribute': 'string',
'matchOffsets': [{'endOffset': 'integer',
'startOffset': 'integer'}],
'text': 'string'}]}]}},
'dataProductListing': {'additionalAttributes': {'matchRationale': [{'textMatches': [{'attribute': 'string',
'matchOffsets': [{'endOffset': 'integer',
'startOffset': 'integer'}],
'text': 'string'}]}]}}}}
Searches listings (records of an asset at a given time) in Amazon DataZone.
See also: AWS API Documentation
Request Syntax
client.search_listings(
additionalAttributes=[
'FORMS'|'TIME_SERIES_DATA_POINT_FORMS'|'TEXT_MATCH_RATIONALE',
],
aggregations=[
{
'attribute': 'string',
'displayValue': 'string'
},
],
domainIdentifier='string',
filters={
'and': [
{'... recursive ...'},
],
'filter': {
'attribute': 'string',
'value': 'string'
},
'or': [
{'... recursive ...'},
]
},
maxResults=123,
nextToken='string',
searchIn=[
{
'attribute': 'string'
},
],
searchText='string',
sort={
'attribute': 'string',
'order': 'ASCENDING'|'DESCENDING'
}
)
list
Specifies additional attributes for the search.
(string) --
list
Enables you to specify one or more attributes to compute and return counts grouped by field values.
(dict) --
An aggregation list item.
attribute (string) -- [REQUIRED]
An attribute on which to compute aggregations.
displayValue (string) --
The display value of the aggregation list item. Supported values include value and glossaryTerm.name.
string
[REQUIRED]
The identifier of the domain in which to search listings.
dict
Specifies the filters for the search of listings.
and (list) --
The 'and' search filter clause in Amazon DataZone.
(dict) --
A search filter clause in Amazon DataZone.
filter (dict) --
A search filter in Amazon DataZone.
attribute (string) -- [REQUIRED]
A search filter attribute in Amazon DataZone.
value (string) -- [REQUIRED]
A search filter value in Amazon DataZone.
or (list) --
The 'or' search filter clause in Amazon DataZone.
(dict) --
A search filter clause in Amazon DataZone.
integer
The maximum number of results to return in a single call to SearchListings. When the number of results to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to SearchListings to list the next set of results.
string
When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to SearchListings to list the next set of results.
list
The details of the search.
(dict) --
The details of the search.
attribute (string) -- [REQUIRED]
The search attribute.
string
Specifies the text for which to search.
dict
Specifies the way for sorting the search results.
attribute (string) -- [REQUIRED]
The attribute detail of the way to sort search results.
order (string) --
The order detail of the wya to sort search results.
dict
Response Syntax
{
'aggregates': [
{
'attribute': 'string',
'displayValue': 'string',
'items': [
{
'count': 123,
'displayValue': 'string',
'value': 'string'
},
]
},
],
'items': [
{
'assetListing': {
'additionalAttributes': {
'forms': 'string',
'latestTimeSeriesDataPointForms': [
{
'contentSummary': 'string',
'formName': 'string',
'id': 'string',
'timestamp': datetime(2015, 1, 1),
'typeIdentifier': 'string',
'typeRevision': 'string'
},
],
'matchRationale': [
{
'textMatches': [
{
'attribute': 'string',
'matchOffsets': [
{
'endOffset': 123,
'startOffset': 123
},
],
'text': 'string'
},
]
},
]
},
'createdAt': datetime(2015, 1, 1),
'description': 'string',
'entityId': 'string',
'entityRevision': 'string',
'entityType': 'string',
'glossaryTerms': [
{
'name': 'string',
'shortDescription': 'string'
},
],
'listingCreatedBy': 'string',
'listingId': 'string',
'listingRevision': 'string',
'listingUpdatedBy': 'string',
'name': 'string',
'owningProjectId': 'string'
},
'dataProductListing': {
'additionalAttributes': {
'forms': 'string',
'matchRationale': [
{
'textMatches': [
{
'attribute': 'string',
'matchOffsets': [
{
'endOffset': 123,
'startOffset': 123
},
],
'text': 'string'
},
]
},
]
},
'createdAt': datetime(2015, 1, 1),
'description': 'string',
'entityId': 'string',
'entityRevision': 'string',
'glossaryTerms': [
{
'name': 'string',
'shortDescription': 'string'
},
],
'items': [
{
'glossaryTerms': [
{
'name': 'string',
'shortDescription': 'string'
},
],
'listingId': 'string',
'listingRevision': 'string'
},
],
'listingCreatedBy': 'string',
'listingId': 'string',
'listingRevision': 'string',
'listingUpdatedBy': 'string',
'name': 'string',
'owningProjectId': 'string'
}
},
],
'nextToken': 'string',
'totalMatchCount': 123
}
Response Structure
(dict) --
aggregates (list) --
Contains computed counts grouped by field values based on the requested aggregation attributes for the matching listings.
(dict) --
The aggregation for an attribute.
attribute (string) --
The attribute for this aggregation.
displayValue (string) --
The display value of the aggregation output item.
items (list) --
A list of aggregation output items.
(dict) --
An aggregation output item.
count (integer) --
The count of the aggregation output item.
displayValue (string) --
The display value of the aggregation. If the attribute being aggregated corresponds to the id of a public resource, the service automatically resolves the id to the provided display value.
value (string) --
The attribute value of the aggregation output item.
items (list) --
The results of the SearchListings action.
(dict) --
The details of the results of the SearchListings action.
assetListing (dict) --
The asset listing included in the results of the SearchListings action.
additionalAttributes (dict) --
The additional attributes of an asset published in an Amazon DataZone catalog.
forms (string) --
The metadata forms that form additional attributes of the metadata asset.
latestTimeSeriesDataPointForms (list) --
The latest time series data points forms included in the additional attributes of an asset.
(dict) --
The summary of the time series data points form.
contentSummary (string) --
The content of the summary of the time series data points form.
formName (string) --
The name of the time series data points summary form.
id (string) --
The ID of the time series data points summary form.
timestamp (datetime) --
The timestamp of the time series data points summary form.
typeIdentifier (string) --
The type ID of the time series data points summary form.
typeRevision (string) --
The type revision of the time series data points summary form.
matchRationale (list) --
List of rationales indicating why this item was matched by search.
(dict) --
A rationale indicating why this item was matched by search.
textMatches (list) --
A list of TextMatchItems.
(dict) --
A structure indicating matched terms for an attribute.
attribute (string) --
The name of the attribute.
matchOffsets (list) --
List of offsets indicating matching terms in the TextMatchItem text.
(dict) --
The offset of a matched term.
endOffset (integer) --
The 0-indexed number indicating the end position (exclusive) of a matched term.
startOffset (integer) --
The 0-indexed number indicating the start position (inclusive) of a matched term.
text (string) --
Snippet of attribute text containing highlighted content.
createdAt (datetime) --
The timestamp of when an asset published in an Amazon DataZone catalog was created.
description (string) --
The description of an asset published in an Amazon DataZone catalog.
entityId (string) --
The identifier of the inventory asset.
entityRevision (string) --
The revision of the inventory asset.
entityType (string) --
The type of the inventory asset.
glossaryTerms (list) --
Glossary terms attached to the inventory asset.
(dict) --
Details of a glossary term attached to the inventory asset.
name (string) --
The name of a glossary term attached to the inventory asset.
shortDescription (string) --
The shoft description of a glossary term attached to the inventory asset.
listingCreatedBy (string) --
The Amazon DataZone user who created the listing.
listingId (string) --
The identifier of the listing (asset published in Amazon DataZone catalog).
listingRevision (string) --
The revision of the listing (asset published in Amazon DataZone catalog).
listingUpdatedBy (string) --
The Amazon DataZone user who updated the listing.
name (string) --
The name of the inventory asset.
owningProjectId (string) --
The identifier of the project that owns the inventory asset.
dataProductListing (dict) --
The data product listing.
additionalAttributes (dict) --
The additional attributes of the asset of the data product.
forms (string) --
The metadata forms of the asset of the data product.
matchRationale (list) --
List of rationales indicating why this item was matched by search.
(dict) --
A rationale indicating why this item was matched by search.
textMatches (list) --
A list of TextMatchItems.
(dict) --
A structure indicating matched terms for an attribute.
attribute (string) --
The name of the attribute.
matchOffsets (list) --
List of offsets indicating matching terms in the TextMatchItem text.
(dict) --
The offset of a matched term.
endOffset (integer) --
The 0-indexed number indicating the end position (exclusive) of a matched term.
startOffset (integer) --
The 0-indexed number indicating the start position (inclusive) of a matched term.
text (string) --
Snippet of attribute text containing highlighted content.
createdAt (datetime) --
The timestamp at which the asset of the data product listing was created.
description (string) --
The description of the asset of the asset of the data product.
entityId (string) --
The entity ID of the asset of the asset of the data product.
entityRevision (string) --
The revision of the asset of the asset of the data product.
glossaryTerms (list) --
The glossary terms of the asset of the asset of the data product.
(dict) --
Details of a glossary term attached to the inventory asset.
name (string) --
The name of a glossary term attached to the inventory asset.
shortDescription (string) --
The shoft description of a glossary term attached to the inventory asset.
items (list) --
The data of the asset of the data product.
(dict) --
The results of the data product summary.
glossaryTerms (list) --
The glossary terms of the data product listing.
(dict) --
Details of a glossary term attached to the inventory asset.
name (string) --
The name of a glossary term attached to the inventory asset.
shortDescription (string) --
The shoft description of a glossary term attached to the inventory asset.
listingId (string) --
The ID of the data product listing.
listingRevision (string) --
The revision of the data product listing.
listingCreatedBy (string) --
The timestamp at which the listing was created.
listingId (string) --
The ID of the listing.
listingRevision (string) --
The revision of the listing.
listingUpdatedBy (string) --
The user who updated the listing.
name (string) --
The name of the asset of the data product.
owningProjectId (string) --
The ID of the owning project of the asset of the data product.
nextToken (string) --
When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to SearchListings to list the next set of results.
totalMatchCount (integer) --
Total number of search results.