{"@context":{"@vocab":"http://schema.org/","goog":"http://schema.googleapis.com/","resultScore":"goog:resultScore","detailedDescription":"goog:detailedDescription","EntitySearchResult":"goog:EntitySearchResult","kg":"http://g.co/kg"},"@type":"ItemList","itemListElement":[{"@type":"EntitySearchResult","result":{"@id":"kg:/m/0dl567","name":"Taylor Swift","@type":["Thing","Person"],"description":"Singer-songwriter","image":{"contentUrl":"https://t1.gstatic.com/images?q=tbn:ANd9GcQmVDAhjhWnN2OWys2ZMO3PGAhupp5tN2LwF_BJmiHgi19hf8Ku","url":"https://en.wikipedia.org/wiki/Taylor_Swift","license":"http://creativecommons.org/licenses/by-sa/2.0"},"detailedDescription":{"articleBody":"Taylor Alison Swift is an American singer-songwriter and actress. Raised in Wyomissing, Pennsylvania, she moved to Nashville, Tennessee, at the age of 14 to pursue a career in country music. ","url":"http://en.wikipedia.org/wiki/Taylor_Swift","license":"https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License"},"url":"http://taylorswift.com/"},"resultScore":4850}]}
[null,null,["最后更新时间 (UTC)：2025-07-25。"],[[["\u003cp\u003eThe Google Knowledge Graph Search API lets you search for entities (people, places, things) using a variety of search parameters like keywords, IDs, and entity types.\u003c/p\u003e\n"],["\u003cp\u003eThe API returns structured data in JSON-LD format, following schema.org standards and Google extensions, providing detailed information about the matched entities.\u003c/p\u003e\n"],["\u003cp\u003eYou can refine searches using language filters, substring matching, and limiting the number of results for efficiency.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes key entity details such as name, description, image, website URL, and a relevance score.\u003c/p\u003e\n"],["\u003cp\u003eYou are responsible for adhering to applicable laws, especially regarding the use of images returned by the API.\u003c/p\u003e\n"]]],[],null,["# Method entities.search\n\nSearches Knowledge Graph for entities that match the constraints.\n\nHTTP request\n------------\n\n GET https://kgsearch.googleapis.com/v1/entities:search\n\nQuery parameters\n----------------\n\n| Parameter name | Type | Description |\n|----------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `query` | `string` | A literal string to search for in the Knowledge Graph. |\n| `ids` | `string` | A list of entity IDs to search for in the Knowledge Graph. To specify multiple IDs in the HTTP request, repeat the parameter in the URL as in ...?ids=A\\&ids=B |\n| `languages` | `string` | The list of language codes (defined in ISO 639) to run the query with, for instance \\`en\\`. |\n| `types` | `string` | Restricts returned entities to those of the specified types. For example, you can specify \\`Person\\` (as defined in \u003chttp://schema.org/Person\u003e) to restrict the results to entities representing people. If multiple types are specified, returned entities will contain one or more of these types. |\n| `indent` | `boolean` | Enables indenting of JSON results. |\n| `prefix` | `boolean` | Enables prefix (initial substring) match against names and aliases of entities. For example, a prefix \\`Jung\\` will match entities and aliases such as \\`Jung\\`, \\`Jungle\\`, and \\`Jung-ho Kang\\`. |\n| `limit` | `number` | Limits the number of entities to be returned. Maximum is 500. Default is 20. Requests with high limits have a higher chance of timing out. |\n\nRequest body\n------------\n\nThe request body must be empty.\n\nResponse body\n-------------\n\nA response message contains a list of entities, presented in\n[JSON-LD](http://json-ld.org) format and compatible with\n[schema.org](http://schema.org) schemas\n(with limited [external extensions](http://schema.googleapis.com)).\n\nThe following JSON-LD example shows how the response body is structured: \n\n {\n \"@context\": {\n \"@vocab\": \"http://schema.org/\",\n \"goog\": \"http://schema.googleapis.com/\",\n \"resultScore\": \"goog:resultScore\",\n \"detailedDescription\": \"goog:detailedDescription\",\n \"EntitySearchResult\": \"goog:EntitySearchResult\",\n \"kg\": \"http://g.co/kg\"\n },\n \"@type\": \"ItemList\",\n \"itemListElement\": [\n {\n \"@type\": \"EntitySearchResult\",\n \"result\": {\n \"@id\": \"kg:/m/0dl567\",\n \"name\": \"Taylor Swift\",\n \"@type\": [\n \"Thing\",\n \"Person\"\n ],\n \"description\": \"Singer-songwriter\",\n \"image\": {\n \"contentUrl\": \"https://t1.gstatic.com/images?q=tbn:ANd9GcQmVDAhjhWnN2OWys2ZMO3PGAhupp5tN2LwF_BJmiHgi19hf8Ku\",\n \"url\": \"https://en.wikipedia.org/wiki/Taylor_Swift\",\n \"license\": \"http://creativecommons.org/licenses/by-sa/2.0\"\n },\n \"detailedDescription\": {\n \"articleBody\": \"Taylor Alison Swift is an American singer-songwriter and actress. Raised in Wyomissing, Pennsylvania, she moved to Nashville, Tennessee, at the age of 14 to pursue a career in country music. \",\n \"url\": \"http://en.wikipedia.org/wiki/Taylor_Swift\",\n \"license\": \"https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License\"\n },\n \"url\": \"http://taylorswift.com/\"\n },\n \"resultScore\": 4850\n }\n ]\n }\n\n### Response fields\n\n| Field name | Type | Description |\n|-----------------------|----------|------------------------------------------------------------------------------------|\n| `@id` | `string` | The canonical URI for the entity. |\n| `name` | `string` | The name of the entity. |\n| `@type` | `array` | The list of supported [schema.org](http://schema.org) types that match the entity. |\n| `description` | `string` | A short description of the entity. |\n| `image` | `URL` | An image to help identify the entity. |\n| `detailedDescription` | `string` | A detailed description of the entity. |\n| `url` | `URL` | The official website URL of the entity, if available. |\n| `resultScore` | `number` | An indicator of how well the entity matched the request constraints. |\n\n| **Note:** Image URLs are provided to help you confirm that you have selected the correct entity. As with all content you obtain through Google APIs, you are responsible for ensuring that your use of the images complies with applicable law.\n\n### JSON-LD keywords\n\nFor JSON-LD keywords such as [@context](http://www.w3.org/TR/json-ld/#the-context)\n, [@vocab](http://www.w3.org/TR/json-ld/#default-vocabulary),\n[@type](http://www.w3.org/TR/json-ld/#specifying-the-type), or\n[@id](http://www.w3.org/TR/json-ld/#node-identifiers), refer to the\n[JSON-LD spec](http://www.w3.org/TR/json-ld/).\n\n### Schema.org compatibility\n\nThe response uses the vocabulary hosted at\n[schema.org](http://schema.org), with limited extensions (for\nexample, `resultScore`) that are compatible with schema.org vocabulary.\nFor more details about these extensions, see\n[List of schema extensions](#list_of_schema_extensions).\n\nFor each of the Schema.org types (such as `Person`) and properties (such as\n`name`) there is a corresponding full URI, as in the following examples:\n\n- Person -\\\u003e http://schema.org/Person\n- Thing -\\\u003e http://schema.org/Thing\n\n- name -\\\u003e http://schema.org/name\n\n- description -\\\u003e http://schema.org/description\n\nTypes and properties defined as Google schema extensions can be\nexpanded with \u003chttp://schema.googleapis.com\u003e.\nFor example,\n\n- EntitySearchResult -\\\u003e http://schema.googleapis.com/EntitySearchResult\n- detailedDescription -\\\u003e http://schema.googleapis.com/detailedDescription\n\nThe documentation for each type and property is available at the\ncorresponding URI.\n\nList of schema extensions\n-------------------------\n\nSchema extensions used in this API are hosted at\n\u003chttp://schema.googleapis.com\u003e\nas [external extensions](http://schema.org/docs/extension.html).\n\nThe **type** extension to Schema.org is:\n\n- [EntitySearchResult](http://schema.googleapis.com/EntitySearchResult)\n\nThe **property** extensions to Schema.org are:\n\n- [detailedDescription](http://schema.googleapis.com/detailedDescription)\n- [resultScore](http://schema.googleapis.com/resultScore)"]]
