get/search/general/query

Search Videos

API Reference & Playground Get started for free

Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access TikTok data through agntdata: Search Videos. Return Search Result. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need video details, creator profiles, and search across accounts and videos programmatically.

Use cases

AI agents that need TikTok data in structured form

Analytics and monitoring pipelines for TikTok content

Research and GTM workflows that combine TikTok signals with other data

Parameters

Name	In	Type	Required	Description
query	query	string	required	—Default: `mr beast`

Responses

Successful Response

{
  "title": "SearchGeneralResponse",
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "videos": {
      "title": "Videos",
      "type": "array",
      "items": {}
    }
  },
  "description": "Schema Class for a Tiktok Search Result Video"
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "Search_Videos",
  "method": "get",
  "path": "/search/general/query",
  "summary": "Search Videos",
  "description": "Return Search Result",
  "parameters": [
    {
      "name": "query",
      "in": "query",
      "required": true,
      "schema": {
        "type": "string",
        "default": "mr beast"
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "title": "SearchGeneralResponse",
            "type": "object",
            "properties": {
              "query": {
                "title": "Query",
                "type": "string"
              },
              "videos": {
                "title": "Videos",
                "type": "array",
                "items": {}
              }
            },
            "description": "Schema Class for a Tiktok Search Result Video"
          },
          "example": {
            "query": "",
            "videos": []
          }
        }
      }
    },
    {
      "statusCode": "422",
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "title": "HTTPValidationError",
            "type": "object",
            "properties": {
              "detail": {
                "title": "Detail",
                "type": "array",
                "items": {
                  "title": "ValidationError",
                  "required": [
                    "loc",
                    "msg",
                    "type"
                  ],
                  "type": "object",
                  "properties": {
                    "loc": {
                      "title": "Location",
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "msg": {
                      "title": "Message",
                      "type": "string"
                    },
                    "type": {
                      "title": "Error Type",
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "example": {
            "detail": [
              {
                "loc": [],
                "msg": "",
                "type": ""
              }
            ]
          }
        }
      }
    }
  ]
}