5.4. get_exact_phrase_popularity

struct of integers get_exact_phrase_popularity(
        string id,
        array of strings keyphrases,
        string case,
        boolean include_misspellings,
        boolean include_plurals,
        string adult_filter,
        integer max,
        integer timeout)

Parameters

id
The client access key supplied by Wordtracker.

keyphrases
Keyphrases to get counts for.

case
The options are 'case_distinct', 'case_folded' and 'case_sensitive'.

include_misspellings
If true, generates misspellings on results.

include_plurals
If true, the keyphrases will generate plural forms.

adult_filter

The adult filter has four levels which can be set with the following flags:

off
No filtering applied. Adult terms will be included in the results.
remove_dubious
Removes all keywords unsuitable for presentations. This is the most aggressive filter and may occasionally remove clean terms.
remove_offensive
Removes offensive keywords.
adult_only
Only displays adult terms.

The following flags have been deprecated: 'include_adult' and 'exclude_adult'.

This filter is applied to the results before they are returned to you.

max
Set this to the maximum number of results you would like returned.

timeout
The cut off time in seconds for the current RPC call.

Description

Enter a seed keyphrase and Wordtracker will generate a hash of keywords and counts from our database of 350 million Dogpile / Metacrawler searches from the last three months. Since this is an 'exact phrase' search, each result term will exactly match the search term. E.g. a search for 'bill clinton' will only return 'bill clinton' and not 'clinton bill'.

KeyphrasePopularity
bill clinton103
BILL CLINTON98

If the case parameter is set to 'case distinct', then the upper and lower case of the returned keyphrases are preserved. E.g. 'golf' could return 'golf 10', 'Golf 9' and 'GOLF 1'. If the case parameter is set to 'case folded', then the upper and lower case forms of the of the results are added together and presented as a single lower case result. E.g. 'golf' could return 'golf 20' with the data in the line above. If the case parameter is set to 'case sensitive', then the result sets are restricted to matching case only. E.g. enter 'GOLF', get 'GOLF 1' only.

If include_misspellings is true, then Wordtracker will also generate a list of mis-spelled forms. This feature is not yet enabled.

If include_plurals is true, then all search terms will also generate additional plural search forms before submission to the Wordtracker database. For example, the search term foot will also include a search for feet.

There are three ways to deal with adult terms. You may exclude them completely with 'exclude_adult'; include them as well with 'include_adult'; or fetch adult terms by themselves with 'adult_only'.

The max parameter specifies the maximum number of results returned. The upper limit is restricted according to the account.

The timeout parameter specifies the cut off time in seconds. The upper limit is restricted according to the account.

If is_adult_filtered is true, then all results will have adult keywords removed.