Yahoo! Search Marketing

KeywordResearchService

KeywordResearchService provides operations for generating keyword recommendations based on historical data, which has been partitioned into range definitions.

Every time this data for this service is refreshed, the range definitions are recalculated. Therefore, every time the data is refreshed you should retrieve the range definitions and store them locally for easy reference when you are interpreting the results form the getRelatedKeywords and getPageReleatedKeywords operations.

Operations

getCanonicalKeywords

Return the canonical form for a set of keywords.

Capability required: Research
License command group: Research

Parameters

Parameter Data Type Description
getCanonicalKeywordsRequest KeywordInfoRequestType The canonical keyword request.

Response

KeywordInfoResponseType - The keywords in canonical form.

getCommonKeywords

Return the phrase canonical form for a set of keywords.

Capability required: Research
License command group: Research

Parameters

Parameter Data Type Description
commonKeywordsRequest KeywordInfoRequestType The common keywords request.

Response

KeywordInfoResponseType - The keywords in common form.

getPageRelatedKeywords

Crawl a URL and return keyword suggestions.

Capability required: Research
License command group: Research

Parameters

Parameter Data Type Description
pageRelatedKeywordRequest PageRelatedKeywordRequestType The page-related keywords request.

Response

RelatedKeywordResponseType - The suggested keywords.

getRangeDefinitions

Return the range definitions. This operation returns a single range definition, Searches. This range definition provides the underlying search data for the getRelatedKeywords and getPageRelatedKeywords operations. Future versions of KeywordResearchService may support additional range definitions.

Capability required: Research
License command group: Research

Parameters

Parameter Data Type Description
rangeDefinitionRequest RangeDefinitionRequestType The range definitions request.

Response

RangeDefinitionResponseType - The range definitions.

getRelatedKeywords

Return keyword suggestions.

Capability required: Research
License command group: Research

Parameters

Parameter Data Type Description
relatedKeywordRequest RelatedKeywordRequestType The related keywords request.

Response

RelatedKeywordResponseType - The suggested keywords.