API Reference / API Methods / Synonyms / Get synonym
Required API Key: any key with the settings ACL
Method signature
$index->getSynonym(string objectID)

About this method # A

Get a single synonym using its object id.

Examples # A

To retrieve a synonym by objectID:

1
$synonym = $index->getSynonym("a-unique-identifier");

Parameters # A

objectID #
type: string
Required

objectID of the synonym you want to retrieve

Response # A

This section shows the JSON response returned by the API. Since each language encapsulates this response inside objects specific to that language and/or implementation, the actual type in your language might differ from what’s written here. You can view the response in the logs (using the getLogs method).

JSON format#

1
2
3
4
5
6
7
8
{
  "objectID": "a-unique-identifier",
  "type": "synonym",
  "synonyms": [
    "car",
    "vehicle"
  ]
}
objectID #
string
Required for only some languages

Must contain the same value as the objectId above.

type #
string
Required

There are 4 synonym types. The parameter can be one of the following values:

  • synonym
  • oneWaySynonym
  • altCorrection1 or altCorrection2
  • placeholder
synonyms #
list
Required if type=synonym or type=oneWaySynonym

A list of synonyms.

input #
string
Required if type=oneWaySynonym

Defines the synonym. A word or expression, used as the basis for the array of synonyms.

word #
string
Required if type=altCorrection1 or type=altCorrection2

A single word, used as the basis for the below array of corrections.

corrections #
list
Required if type=altCorrection1 or type=altCorrection2

An list of corrections of the word.

placeholder #
string
Required if type=placeholder

A single word, used as the basis for the below list of replacements.

replacements #
list
Required if type=placeholder

An list of replacements of the placeholder.

Did you find this page helpful?
PHP v3