--- title: "Google Trends" method: POST path: "/v1/google/trends" tags: ["Google"] --- # Google Trends `POST /v1/google/trends` ## Request - Base URL: `https://api.prismcrawl.com` - URL: `https://api.prismcrawl.com/v1/google/trends` - Auth: API key in header `x-api-key` Retrieve Google Trends data for one to five comma-separated terms. time_range accepts all, now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, or an ordered YYYY-MM-DD date pair from 2004 through today. ## Request body - CatalogGoogleTrendsRequest: Retrieve Google Trends data for one to five comma-separated terms. time_range accepts all, now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, or an ordered YYYY-MM-DD date pair from 2004 through today. - `query` string, required: Text to search for on the selected service. At most 8,192 UTF-8 bytes. - `country` string: Two-letter country or storefront code, such as us or gb. - `language` string: Provider-supported language code, such as en. - `category` 'interest_over_time' | 'interest_by_region' | 'related_queries' | 'related_topics': A category identifier supported by this operation. - `time_range` string: Provider-supported time filter. - `device` 'desktop' | 'mobile' | 'tablet': Device presentation for the source request. - `html` boolean: Return the encoded original response rather than parsed JSON. - `zero_trace` boolean: Do not archive source or parsed response artifacts. - `data_type` 'TIMESERIES' | 'GEO_MAP' | 'GEO_MAP_0' | 'RELATED_TOPICS' | 'RELATED_QUERIES': Chart: TIMESERIES (default), GEO_MAP for comparing terms, GEO_MAP_0 for one term, or related topics/queries. Cannot be combined with the legacy category selector. - `geo` string: Google Trends location code. An empty string selects worldwide. A comma-separated location per term is supported for TIMESERIES. Overrides country. - `region` 'COUNTRY' | 'REGION' | 'DMA' | 'CITY': Geographic chart resolution, for GEO_MAP and GEO_MAP_0 only. - `cat` 0 | 3 | 5 | 7 | 8 | 11 | 12 | 13 | 14 | 16 | 18 | 19 | 20 | 22 | 23 | 24 | 25 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 73 | 74 | 75 | 76 | 77 | 78 | 82 | 83 | 84 | 89 | 91 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | 102 | 104 | 105 | 107 | 108 | 112 | 113 | 115 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 137 | 138 | 143 | 144 | 145 | 146 | 147 | 148 | 154 | 157 | 158 | 166 | 168 | 170 | 171 | 174 | 179 | 180 | 182 | 184 | 185 | 188 | 189 | 191 | 195 | 198 | 202 | 203 | 205 | 206 | 208 | 210 | 211 | 213 | 215 | 216 | 217 | 218 | 220 | 224 | 225 | 226 | 227 | 228 | 229 | 230 | 231 | 233 | 234 | 235 | 236 | 237 | 238 | 239 | 241 | 242 | 244 | 245 | 246 | 248 | 249 | 250 | 251 | 252 | 253 | 254 | 255 | 256 | 257 | 258 | 259 | 260 | 261 | 262 | 263 | 264 | 265 | 268 | 269 | 270 | 271 | 272 | 273 | 275 | 276 | 277 | 278 | 279 | 280 | 284 | 287 | 288 | 289 | 290 | 291 | 292 | 293 | 294 | 296 | 297 | 298 | 299 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | 308 | 309 | 310 | 311 | 312 | 313 | 314 | 315 | 316 | 317 | 318 | 319 | 320 | 321 | 323 | 324 | 326 | 327 | 328 | 329 | 330 | 331 | 332 | 333 | 334 | 335 | 336 | 337 | 338 | 340 | 341 | 342 | 343 | 344 | 346 | 347 | 350 | 352 | 353 | 354 | 355 | 356 | 357 | 358 | 359 | 360 | 361 | 362 | 364 | 365 | 366 | 367 | 369 | 371 | 372 | 373 | 374 | 375 | 377 | 378 | 379 | 380 | 381 | 382 | 383 | 384 | 385 | 386 | 389 | 390 | 392 | 394 | 396 | 398 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 408 | 409 | 410 | 412 | 418 | 419 | 420 | 421 | 422 | 423 | 424 | 425 | 426 | 427 | 428 | 429 | 432 | 433 | 434 | 435 | 436 | 437 | 438 | 439 | 440 | 441 | 442 | 443 | 444 | 445 | 446 | 447 | 448 | 449 | 450 | 451 | 456 | 457 | 458 | 459 | 461 | 462 | 463 | 465 | 466 | 467 | 468 | 471 | 472 | 473 | 474 | 477 | 485 | 486 | 487 | 488 | 492 | 493 | 494 | 495 | 496 | 497 | 498 | 499 | 500 | 501 | 502 | 503 | 504 | 505 | 507 | 508 | 509 | 510 | 511 | 512 | 513 | 514 | 515 | 516 | 517 | 518 | 519 | 520 | 521 | 522 | 527 | 528 | 529 | 530 | 531 | 532 | 533 | 534 | 535 | 536 | 538 | 539 | 540 | 541 | 542 | 543 | 546 | 547 | 548 | 549 | 550 | 551 | 552 | 554 | 555 | 556 | 557 | 558 | 559 | 560 | 563 | 565 | 566 | 567 | 568 | 569 | 571 | 572 | 573 | 574 | 575 | 576 | 577 | 578 | 579 | 580 | 581 | 582 | 585 | 586 | 587 | 588 | 589 | 590 | 591 | 592 | 593 | 606 | 607 | 608 | 609 | 610 | 611 | 612 | 613 | 614 | 615 | 616 | 617 | 618 | 619 | 620 | 621 | 622 | 623 | 624 | 625 | 626 | 627 | 628 | 629 | 630 | 631 | 632 | 633 | 634 | 635 | 636 | 638 | 639 | 640 | 641 | 642 | 643 | 644 | 645 | 646 | 647 | 648 | 649 | 650 | 651 | 652 | 653 | 654 | 655 | 656 | 657 | 658 | 659 | 660 | 661 | 662 | 663 | 664 | 665 | 666 | 667 | 668 | 669 | 670 | 671 | 672 | 673 | 674 | 675 | 676 | 677 | 678 | 679 | 680 | 681 | 682 | 683 | 685 | 686 | 687 | 688 | 689 | 690 | 691 | 692 | 693 | 694 | 695 | 696 | 697 | 699 | 700 | 701 | 702 | 703 | 704 | 705 | 706 | 707 | 708 | 717 | 718 | 719 | 720 | 721 | 722 | 723 | 724 | 725 | 726 | 727 | 728 | 729 | 730 | 731 | 732 | 733 | 734 | 735 | 736 | 737 | 739 | 740 | 741 | 742 | 743 | 744 | 745 | 746 | 747 | 748 | 749 | 750 | 751 | 752 | 784 | 785 | 786 | 787 | 788 | 791 | 792 | 793 | 794 | 799 | 800 | 801 | 802 | 803 | 804 | 805 | 806 | 807 | 808 | 809 | 810 | 811 | 812 | 813 | 814 | 815 | 816 | 817 | 818 | 819 | 820 | 821 | 822 | 823 | 824 | 825 | 826 | 827 | 828 | 829 | 830 | 831 | 832 | 833 | 834 | 835 | 836 | 837 | 838 | 839 | 840 | 841 | 842 | 843 | 844 | 845 | 846 | 847 | 848 | 849 | 850 | 851 | 852 | 853 | 854 | 855 | 856 | 857 | 858 | 859 | 860 | 861 | 862 | 863 | 864 | 865 | 866 | 867 | 868 | 869 | 870 | 882 | 883 | 884 | 885 | 886 | 887 | 888 | 889 | 890 | 891 | 892 | 893 | 894 | 895 | 896 | 897 | 898 | 899 | 900 | 901 | 902 | 903 | 904 | 905 | 906 | 907 | 908 | 909 | 910 | 911 | 912 | 913 | 914 | 915 | 916 | 917 | 918 | 919 | 920 | 921 | 922 | 923 | 924 | 925 | 926 | 927 | 928 | 929 | 930 | 931 | 932 | 933 | 935 | 936 | 937 | 938 | 939 | 940 | 941 | 942 | 943 | 944 | 945 | 946 | 947 | 948 | 949 | 950 | 951 | 952 | 953 | 954 | 955 | 956 | 957 | 958 | 959 | 960 | 961 | 962 | 963 | 964 | 965 | 966 | 967 | 968 | 969 | 970 | 972 | 973 | 974 | 975 | 976 | 977 | 978 | 979 | 980 | 981 | 982 | 983 | 984 | 985 | 986 | 987 | 988 | 989 | 990 | 991 | 992 | 993 | 994 | 995 | 996 | 997 | 998 | 999 | 1000 | 1001 | 1002 | 1003 | 1004 | 1005 | 1006 | 1007 | 1008 | 1009 | 1010 | 1011 | 1012 | 1013 | 1014 | 1015 | 1016 | 1017 | 1019 | 1020 | 1021 | 1022 | 1023 | 1024 | 1025 | 1026 | 1027 | 1028 | 1030 | 1031 | 1032 | 1033 | 1034 | 1035 | 1036 | 1037 | 1038 | 1039 | 1040 | 1041 | 1043 | 1044 | 1045 | 1046 | 1047 | 1048 | 1049 | 1050 | 1055 | 1056 | 1057 | 1058 | 1059 | 1060 | 1061 | 1062 | 1063 | 1064 | 1065 | 1066 | 1067 | 1068 | 1069 | 1070 | 1071 | 1072 | 1073 | 1074 | 1075 | 1076 | 1077 | 1078 | 1079 | 1080 | 1081 | 1082 | 1083 | 1084 | 1085 | 1086 | 1087 | 1088 | 1089 | 1090 | 1091 | 1092 | 1093 | 1094 | 1095 | 1096 | 1097 | 1098 | 1099 | 1100 | 1101 | 1102 | 1103 | 1104 | 1105 | 1106 | 1107 | 1108 | 1109 | 1110 | 1111 | 1112 | 1113 | 1114 | 1115 | 1116 | 1117 | 1118 | 1119 | 1120 | 1121 | 1122 | 1123 | 1124 | 1125 | 1126 | 1127 | 1131 | 1132 | 1133 | 1134 | 1135 | 1136 | 1137 | 1138 | 1139 | 1140 | 1141 | 1142 | 1143 | 1144 | 1145 | 1146 | 1147 | 1148 | 1149 | 1150 | 1152 | 1153 | 1155 | 1157 | 1158 | 1159 | 1160 | 1161 | 1162 | 1163 | 1164 | 1165 | 1166 | 1167 | 1168 | 1169 | 1170 | 1171 | 1173 | 1174 | 1175 | 1176 | 1177 | 1178 | 1179 | 1180 | 1181 | 1182 | 1183 | 1184 | 1185 | 1186 | 1187 | 1188 | 1189 | 1190 | 1191 | 1192 | 1193 | 1194 | 1195 | 1198 | 1199 | 1200 | 1201 | 1202 | 1203 | 1204 | 1205 | 1206 | 1207 | 1208 | 1209 | 1210 | 1211 | 1212 | 1213 | 1214 | 1215 | 1216 | 1217 | 1218 | 1219 | 1220 | 1221 | 1222 | 1223 | 1224 | 1225 | 1226 | 1227 | 1228 | 1229 | 1230 | 1231 | 1232 | 1233 | 1234 | 1235 | 1236 | 1237 | 1238 | 1239 | 1240 | 1241 | 1242 | 1243 | 1244 | 1245 | 1246 | 1247 | 1248 | 1249 | 1250 | 1251 | 1252 | 1253 | 1254 | 1255 | 1256 | 1257 | 1258 | 1259 | 1260 | 1261 | 1262 | 1263 | 1264 | 1265 | 1266 | 1267 | 1268 | 1269 | 1270 | 1271 | 1272 | 1273 | 1274 | 1275 | 1276 | 1277 | 1278 | 1279 | 1280 | 1281 | 1282 | 1283 | 1284 | 1285 | 1286 | 1287 | 1288 | 1289 | 1290 | 1291 | 1292 | 1293 | 1294 | 1296 | 1298 | 1299 | 1300 | 1301 | 1302 | 1303 | 1304 | 1305 | 1306 | 1307 | 1308 | 1309 | 1310 | 1311 | 1312 | 1313 | 1314 | 1315 | 1316 | 1317 | 1318 | 1319 | 1320 | 1321 | 1322 | 1323 | 1324 | 1325 | 1326 | 1327 | 1328 | 1329 | 1330 | 1331 | 1332 | 1333 | 1334 | 1339 | 1340 | 1341 | 1342 | 1343 | 1344 | 1345 | 1346 | 1347 | 1348 | 1349 | 1350 | 1351 | 1352 | 1353 | 1354 | 1355 | 1356 | 1357 | 1358 | 1359 | 1360 | 1361 | 1362 | 1363 | 1364 | 1365 | 1366 | 1367 | 1368 | 1369 | 1370 | 1371 | 1372 | 1373 | 1374 | 1375 | 1376 | 1377 | 1378 | 1379 | 1380 | 1381 | 1382 | 1383 | 1384 | 1385 | 1386 | 1387 | 1388 | 1389 | 1390 | 1391 | 1392 | 1393 | 1394 | 1395 | 1396 | 1397: Google Trends topic category ID. Defaults to 0 (all categories). - `gprop` '' | 'images' | 'news' | 'froogle' | 'youtube': Search property: empty for web search, images, news, froogle (shopping), or youtube. - `date` string: Relative or custom date range; alias of time_range. For TIMESERIES, comma-separated custom ranges match the query order. - `csv` boolean: Also retrieve the source CSV rows. - `include_low_search_volume` boolean: Include low search volume regions in geographic charts. - `tz` integer: UTC offset in minutes, using the browser convention (420 = UTC-07:00). Defaults to 0. - `output` 'json' | 'html' | 'md' | 'null', nullable: Response content format. md returns Markdown in data.content with data.format=md; the JSON success/request envelope remains. Accept: text/markdown also selects Markdown unless output or html=true is explicit. html is an alias for html=true and retains the existing Brotli/Base64 source format. - `json_restrictor` string, nullable: Select fields within data.content for JSON or Markdown. Supports comma-separated paths, non-negative array indices, half-open slices [0:3] (either bound may be omitted), [] and .{nested,subqueries}. Up to128 selections and16 levels. Missing fields are omitted; selected declared fields retain their zero defaults. The request envelope and credit headers remain. Include next_page_token when pagination is needed. Incompatible with HTML output. This changes response presentation only; tracing-enabled history retains the complete JSON result. - `no_cache` boolean, nullable: Accepted for compatibility. Searches are always fetched without a result cache for either value; normal successful-request billing applies. ## Response `200` Request completed. One credit is charged, including recognized empty or unavailable source results and source inventory changes discovered after a valid continuation is fetched. These completed responses may preserve verified partial results; operational failures remain errors. - CatalogGoogleTrendsResponse - `success` true, required - `request_id` string, uuid, required - `data` union, required - MarkdownSearchData - `format` union, required - '' - 'md' - `content` string, required: Markdown derived from the parsed result, after any json_restrictor selection. - ProjectedSearchData - `format` union, required - '' - 'json' - `content` object, required: Only fields selected by json_restrictor. Selected fields retain their declared types and zero defaults. - object - `format` 'json', required - `content` object, required - `averages` number[], required - `csv` array[], required - string[] - `has_next_page` boolean, required - `next_page_token` string, required: Opaque continuation token valid for one hour and the same account. Retain search parameters, device, and result limit. Restart pagination if the token is expired or rejected; tokens from before the authenticated-token rollout cannot be reused. - `results` object[], required - `address` union, required - string - object - string[] - `category` string, required - `columnData` object[], required - `formattedTime` string, required - `formattedValue` string, required - `isPartial` boolean, required - `time` string, required - `value` number, required - `coordinates` object, required - `latitude` number, required - `longitude` number, required - `description` string, required - `formattedAxisTime` string, required - `formattedTime` string, required - `formattedValue` string[], required - `geoCode` string, required - `geoName` string, required - `hasData` boolean[], required - `id` string, required - `isPartial` boolean, required - `latitude` number, required - `longitude` number, required - `name` string, required - `phone` string, required - `position` integer, required - `query` string, required - `rank` integer, required - `rankedKeyword` object[], required - `formattedValue` string, required - `link` string, required - `query` string, required - `topic` object, required - … - `value` number, required - `rating` union, required - number - string - `rating_max` number, required - `rating_source` string, required - `review_count` union, required - number - string - `snippet` string, required - `thumbnail` string, required - `time` string, required - `title` string, required - `type` string, required - `url` string, required - `value` number[], required - `website` string, required - `search_parameters` object, required - `cat` integer, required - `category` string, required - `country` string, required - `csv` boolean, required - `data_type` string, required - `date` string, required - `device` string, required - `engine` string, required - `geo` string, required - `gprop` string, required - `include_low_search_volume` boolean, required - `language` string, required - `operation` string, required - `pagination_limited` boolean, required: True when further pagination is unavailable. A completed source-stale request can contain verified results or an empty array; next_page_token is an empty string. - `pagination_reason` string, required: stale_cursor means a valid continuation was fetched but its source inventory changed. The HTTP 200 response is billable; keep any verified results and restart pagination. - `query` string, required - `region` string, required - `time_range` string, required - `type` string, required - `tz` integer, required - `url` string, required - `serp_features` object[], required - `confidence` number, required - `engine` string, required - `extracted_at` string, required - `id` string, required - `items` object[], required - `link` string, required - `product_id` string, required - `text` string, required - `thumbnail` string, required - `title` string, required - `links` object[], required - `title` string, required - `url` string, required - `position` object, required - `absolute` integer, required - `source_result_ids` string[], required - `text` string, required - `title` string, required - `type` string, required - GoogleHtmlSearchData - `format` union, required - '' - 'html+br+base64' - `content` string, byte, required: Base64-encoded bytes. Decode Base64 first, then decompress the result with Brotli. Available deferred or lazy-loaded thumbnail sources are placed in image src attributes, within size limits; image and video files are not downloaded. When rewrite_links is true, already-resolved opaque Google anchor links use their destination URLs. Unresolved links are preserved. ## Other responses - `400`: The JSON body, source selection, or continuation is invalid. Locally malformed, forged, expired, or mismatched tokens are rejected before source work and require restarting pagination. A source may also reject an otherwise well-formed selector after acquisition. These errors do not spend a search credit. Source inventory changes discovered during a valid request return a completed response instead. - `401`: The API token is missing, invalid, expired, or revoked. - `402`: No credits remain. - `429`: Account rate limit exceeded. - `500`: The request could not be completed. --- [API](https://skmtc.dev/prismcrawl/apis/prismcrawl-api.md) · [All operations](https://skmtc.dev/prismcrawl/apis/prismcrawl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prismcrawl/apis/prismcrawl-api/revisions/eef17f6c02a5?raw)