data365_tiktok_keywords

This component enables real-time and historical data collection of Tiktok content based on keywords

Compatible Metadata Fields

Applicable Metadata CategoriesCompatible
SourceYes
ContentYes
AuthorYes
PersonNo
EnrichmentYes
OrganizationNo
Data source-specific fields?Yes, please see the Metadata page.

Compatible Filters

Filter NameDescription
queryList of keywords or a phrase to search
query_fromFilter dates from/since - Example '2024-05-01T00:00:00Z'
query_toFilter dates to - Example '2024-08-01T00:00:00Z'
max_documentsThe maximum number of documents to be returned. Due to the asynchronous nature of pipelines this is a soft limit and more documents may be returned

Creating Data Collection Job

Example for creating a data collection job from data365_tiktok_keywords data source, for content having keyword "cats" and published between 2023-10-01 and 2023-10-02 only.

curl --location 'https: //api.platform.datastreamer.io/api/pipelines/{PIPELINE_ID}/components/{COMPONENT_ID}/jobs?ready=true' \
      --header 'apikey: <your-api-key>' \
      --header 'Content-Type: application/json' \
      --data \
        '{
            "job_name": "my tiktok data collection",
            "data_source": "data365_tiktok_keywords",
            "from": "2023-10-01",
            "to": "2023-10-02",
            "query": "cats",
            "job_type": "oneTime"
        }'

For more details on creating data collection jobs, see Job Management

Search Query

Data365 Tiktok API keywords search query accepts list of keywords or phrase to search.

For more details on supported search operators, see Data365 Tiktok API

Search Query Examples

Example 1 - cats or dogs since '2024-10-01' until now

{
    "data_source": "data365_tiktok_keywords",
    "job_type": "oneTime",
    "query_from": "2024-10-01T00:00:00Z",
    "query_to": null,
    "query": "(\"cats\" OR \"dogs\")"
}