# Search in tiktok ads

Endpoint: POST /tiktok/ads/search
Version: 1.0.0

## Request fields (application/json):

  - `api_key` (string)
    Your API Key token.
    Example: "YOUR_API_KEY_HERE"

  - `last_hit` (integer)
    after first page send the current timestamp in seconds

  - `page` (integer)
    Example: 1

  - `orderby` (string)
    Enum: "popularity", "updated_at", "oldest", "seen_counts", "days_active", "domain.traffic"

## Response 200 fields (application/json):

  - `status` (string, required)
    Enum: "ok", "failed"

  - `meta` (object, required)

  - `meta.code` (integer)
    Example: 1000

  - `meta.message` (string,null)

  - `data` (object, required)

  - `data.ads` (array)

  - `data.ads.id` (integer)
    Ad's id
    Example: 1234

  - `data.ads.title` (string)
    Ad's title
    Example: "test title"

  - `data.ads.engagements` (object)

  - `data.ads.engagements.likes` (integer)
    Example: 100

  - `data.ads.engagements.shares` (integer)
    Example: 100

  - `data.ads.engagements.favorites` (integer)
    Example: 100

  - `data.ads.engagements.comments` (integer)
    Example: 100

  - `data.ads.engagements.plays` (integer)
    Example: 100

  - `data.ads.duration` (integer,null)
    video duration
    Example: 100

  - `data.ads.seen_counts` (integer)
    number of seen counts
    Example: 100

  - `data.ads.updated_at` (string)
    last updated time
    Example: "2022-06-28T09:07:10.000000Z"

  - `data.ads.active_days` (integer)
    Ad's active days
    Example: 100

  - `data.ads.attachments` (array)

  - `data.ads.attachments.id` (integer)
    Example: 10

  - `data.ads.attachments.files` (object)

  - `data.ads.attachments.files.main` (string)
    if attachment is video it's video file path otherwise it is image path
    Example: "https://cdn.adflex.io/example-100x100.png"

  - `data.ads.attachments.files.thumbnail` (string)
    if attachment is video it is thumbnail path
    Example: "https://cdn.adflex.io/example-100x100.png"

  - `data.ads.owner` (object)

  - `data.ads.owner.name` (string)
    Example: "test"

  - `data.ads.owner.avatar_url` (string)
    Owner's avatar url
    Example: "https://cdn.adflex.io/example-100x100.png"

  - `data.ads.locations` (array)

  - `data.ads.locations.label` (string)
    Example: "Netherlands"

  - `data.current_page` (integer)
    Current request page
    Example: 1

  - `data.has_next_page` (boolean)
    Defines that next page has ads or not

  - `data.last_hit` (integer)
    after first page send the current timestamp in seconds
    Example: 12321321