Skip to content
Ads API •References / targets / Get Interest Targets

Get Interest Targets

Returns interest targets information. If no query parameter is provided, all interest targets will be returned.

Request

  • ids
    array of strings

    A list of unique identifiers for interests.

    Example: ids=ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • q
    string

    Query to search by keyword via case-insensitive wildcard matching.

    Example: q=query

Response

A list of interest targets.

    • id
      string
    • name
      string
    • id
      string
    • name
      string
      • id
        string
      • name
        string

Response sample

{  "interestsWithSubtargets": [    {      "id": "661a6418-1fa0-4640-a86b-8fb1ef5249f8",      "name": "Academic Interests",      "subtargets": [        {          "id": "32147515-b339-4b35-80c7-309ce4bb9024",          "name": "Clinical Science"        },        {          "id": "5bd1a4c8-11db-4245-85f7-b3571aec0a9e",          "name": "History"        },        {          "id": "b7167be4-4a1f-421d-96b8-6211d723e3ad",          "name": "Medicine and Healthcare"        }      ]    },    {      "id": "5012bb54-9ff3-404e-b892-afffa7e08cdf",      "name": "Business and Finance",      "subtargets": [        {          "id": "1f926bd0-bc40-49db-8a70-d8fcc068be58",          "name": "Marketing and advertising"        },        {          "id": "91e181b4-a0ad-4ab5-bd66-64457da7d1db",          "name": "Sales"        }      ]    }  ]}