# Search Pinterest ads

Endpoint: POST /v2/ads/pinterest/search
Version: 2.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `last_hit` (integer)
    Snapshot timestamp returned in data.last_hit by the page 1 response. Omit this field for page 1. For page 2 and later, resend the original value unchanged while using the same filters and sorting. This value does not expire.

  - `page` (integer)
    Requested page number. Each page returns up to 18 ads. The page size is fixed and cannot be changed.

  - `advanced_order` (object)

  - `advanced_order.orderby` (string)

  - `advanced_order.order` (string)

  - `target_age` (array)

  - `gender` (array)

  - `placements` (array)

  - `search_field` (array)

  - `search_field.type` (string)

  - `search_field.text` (string)

## Response 200 fields (application/json):

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

  - `meta` (object, required)

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

  - `meta.message` (string)
    Example: null

  - `data` (object, required)

  - `data.ads` (array)

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

  - `data.ads.is_bookmarked` (boolean)
    Example: true

  - `data.ads.platform` (string)
    Example: pinterest

  - `data.ads.display_url` (string)
    Ad's target domain
    Example: google.com

  - `data.ads.similarweb` (integer)
    Estimated monthly domain visits
    Example: 1500

  - `data.ads.last_seen` (string)
    last updated time
    Example: 10 minutes ago

  - `data.ads.post_url` (string)
    URL of the ad on Pinterest
    Example: https://pinterest.com/10000

  - `data.ads.owner` (object)

  - `data.ads.owner.id` (integer)
    Example: 100000

  - `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.owner.is_verified` (boolean)
    Owner is verified

  - `data.ads.attachments` (array)

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

  - `data.ads.attachments.type` (string)
    Enum: "image", "video"

  - `data.ads.attachments.url` (string)
    For video attachments, the video URL; for image attachments, the image URL
    Example: https://cdn.adflex.io/example-100x100.png

  - `data.ads.attachments.thumbnail` (string)
    Thumbnail URL for video attachments
    Example: https://cdn.adflex.io/example-100x100.png

  - `data.ads.attachments.subtitle` (string)
    Example: test

  - `data.ads.attachments.duration` (integer)
    Example: 15

  - `data.ads.stats` (array)
    Example: [{"tooltip":"Like","value":10,"icon":"like"},{"tooltip":"Save","value":10,"icon":"download"},{"tooltip":"Repin","value":10,"icon":"arrow-rotate"}]

  - `data.ads.stats.tooltip` (string)

  - `data.ads.stats.value` (integer)

  - `data.ads.stats.icon` (string)

  - `data.ads.metadata` (array)
    Example: [{"tooltip":"Region","value":["flag-ar","flag-de","flag-fr"]},{"tooltip":"Estimated Impression","value":10},{"tooltip":"Days Running","value":"15 Days"}]

  - `data.ads.metadata.tooltip` (string)

  - `data.ads.metadata.value` (any)

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

  - `data.has_next_page` (boolean)
    Indicates whether more results are available

  - `data.last_hit` (integer)
    The timestamp in seconds used for snapshot pagination
    Example: 12321321