iscander01

curl --location 'http://localhost:3011/api/v1/tiktok/search' \
--data '{"query": "Find up to 15 public tiktok influencers from Sweden who post about music"}'

{
    "statusCode": 201,
    "data": {
        "taskId": "d68e72e8-4033-416a-b563-8d0c3b215e6c"
    },
    "message": "Created successfully"
}

iscander01

{
    "statusCode": 200,
    "data": {
        "taskId": "fa0e2af7-3a70-4ebb-b2e1-3c0c80525b1d",
        "status": "completed",
        "error": null,
        "startedAt": "2025-12-18T01:20:05.005Z",
        "completedAt": "2025-12-18T01:44:57.290Z",
        "instagramProfiles": [],
        "tiktokProfiles": [

iscander01

================================================================================
TIKTOK SEARCH ENDPOINT - COMPLETE FLOW DOCUMENTATION
================================================================================

This document describes the complete flow of the POST /tiktok/search endpoint,
from HTTP request to final result storage.

================================================================================
1. HTTP REQUEST (Controller Layer)
================================================================================

iscander01

{
  "profile": "baker_miss_by_carol",
  "analysis": {
    "summary": "Carolina Macedo runs a highly authentic food and travel-focused Instagram profile based in Portugal, primarily covering restaurant reviews in Lisbon and travel experiences. Her content demonstrates genuine passion for culinary experiences and travel, with a strong emphasis on detailed restaurant reviews and food recommendations. The profile maintains consistent engagement with a highly authentic following, particularly strong on video content featuring restaurant reviews and travel experiences. Her bilingual approach (Portuguese/English) helps reach a broader audience while maintaining local authenticity. The engagement rates are notably high at 6.38%, well above industry averages, suggesting a highly engaged and genuine follower base. Content quality is consistently high, with detailed storytelling and personal experiences in both food and travel niches.",
    "qualityScore": 4.5,
    "topic": "Food and Travel",
    "niche": "Restaurant Re

iscander01

{
  "statusCode": 200,
  "data": {
    "taskId": "5e5fbd14-e2f9-44a6-a36b-59360b65c7f3",
    "status": "completed",
    "result": "{\"query\":\"Find up to 15 public Instagram accounts from Portugal who post about cooking and have not more than 50000 followers.\",\"context\":{\"category\":\"cooking\",\"results_count\":15,\"location\":\"Portugal\",\"followers_range\":\"not more than 50000\"},\"searchPrompt\":\"Find public Instagram accounts from Portugal who post about cooking and have at least not more than 50000 followers.\\n\\nOnly include accounts for which you have a verified direct URL to instagram.com from credible web sources.\\n(Return only Instagram URLs that appear in these external sources.)\\nDo not invent usernames.\\nIf uncertain, exclude the account.\\nReturn only the list of URLs with no extra text.\",\"stage1Prompt\":\"Find public Instagram accounts from Portugal who post about cooking and have at least not more than 50000 followers.\\n\\nOnly include accounts for which you have a verified dir

iscander01

{
  "nodes": [
    {
      "parameters": {
        "workflowInputs": {
          "values": [
            {
              "name": "profile"
            },
            {