From b29922a8f3aee1be31457d4b3a8a11592c7160ff Mon Sep 17 00:00:00 2001 From: Paul Date: Tue, 20 Aug 2024 09:50:49 -0400 Subject: [PATCH 1/2] document using --query-file-json multiple times, and new flag --video-id in, README --- README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0f7a3a5..d64359a 100644 --- a/README.md +++ b/README.md @@ -195,6 +195,11 @@ account with `--region` (this flag can be provided multiple times include multiple regions). See tiktok API documentation for more info about this field https://developers.tiktok.com/doc/research-api-specs-query-videos/ +### Video by ID +If you know the ID of the video you want, you can query for it directly with +`--video-id`. NOTE: you will still have to provide start and end dates (due to +TikTok Research API design). + ### fetching user info `--fetch-user-info` For each video the API returns user info is fetched for the video's creator. (for more about what TikTok research API provides and how it is structured see https://developers.tiktok.com/doc/research-api-specs-query-user-info) @@ -223,7 +228,8 @@ This prints the JSON query to stdout. ## Advanced queries If the provided querying functionality does not meet your needs or you want to provide your own query use the `--query-file-json` flag. This takes a path to a -JSON file that will be used as the query for requests to the API. NOTE: the +JSON file that will be used as the query for requests to the API, and can be +used multiple times in the same command to run those queries serially. NOTE: the provided file is NOT checked for validity. See tiktok documentation for more info about crafting queries https://developers.tiktok.com/doc/research-api-get-started/ From e2e574400fec207e5bded8dd91ff28d61e3fe6c1 Mon Sep 17 00:00:00 2001 From: Paul Date: Tue, 20 Aug 2024 09:51:48 -0400 Subject: [PATCH 2/2] make header consistent with others --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index d64359a..5604ca3 100644 --- a/README.md +++ b/README.md @@ -195,7 +195,7 @@ account with `--region` (this flag can be provided multiple times include multiple regions). See tiktok API documentation for more info about this field https://developers.tiktok.com/doc/research-api-specs-query-videos/ -### Video by ID +### Video ID If you know the ID of the video you want, you can query for it directly with `--video-id`. NOTE: you will still have to provide start and end dates (due to TikTok Research API design).