# MatchReference

The percent-encoded references of documents to use to restrict the term occurrence information. If you set `MatchReference`, TermGetInfo returns information about the number of documents in the specified set that contain the query terms, and the total number of times the terms occur in those documents.

You can also set the ReferenceField parameter to specify the reference field that these reference values must occur in.

If the reference contains plus symbols (`+`) or spaces, you must percent-encode the reference twice. If you have multiple references, percent-encode each reference separately once, then separate the references with plus symbols (there must be no space before or after a plus symbol) and percent-encode the whole string again (using a Web browser or the ACI client).

Reference encoding example.

If you have the following two references:

- http://www.example.com/?script.pl&query=test

- http://www.example.com/?script.pl&query=cat+dog

Percent-encode each reference:

    http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dtest

    http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dcat%2Bdog

Separate the two references with a plus symbol:

    http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dtest+http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dcat%2Bdog

Percent-encode the whole string again:

    http%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dtest%2Bhttp%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dcat%252Bdog

Actions: | TermGetInfo
Type: | String
Default: |
Example: | `MatchReference=http%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dtest%2Bhttp%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dcat%252Bdog`
See Also: |

_FT_HTML5_bannerTitle.htm