---
search:
  tags:
    - Targeting options
    - GET
seo:
  description: >-
    Available on: Meta. Reference for the GET
    /observe/{advertiserId}/targeting-options endpoint in the AdCrunch API.
sidebar:
  label: Search the Meta interests and job titles
  badge: GET
title: Search the Meta interests and job titles
type: openapi-operation
---
**Available on:** [![Meta](/providers/meta.svg)](https://docs.adcrunch.dev/connect/providers)

Live read. Asks Meta now for the interests or the job titles whose name matches `q`, as this ad account can target them. Send the `id` of each option that you choose in `interests` or `workPositions` when you create an ad set.

Keep the `id`, not the name: Meta can rename an option. `audienceSizeLowerBound` and `audienceSizeUpperBound` give the size of the audience that Meta estimates for the option alone. `path` gives the category of an interest. A field that Meta does not give is null. Meta gives at most 45 options on one page.

An advertiser that your organization does not own answers `404`, with `error` of `not_found`. An advertiser that does not exist, and one that is not a Meta ad account, answer the same.

AdCrunch stores nothing from this read. Each request counts against the rate limits of Meta.

`limit` and `cursor` page the answer. Send `nextCursor` back as `cursor` to get the next page. A page can hold no row and still carry `nextCursor`.

`GET /observe/{advertiserId}/targeting-options`

**Responses**

- `200` — The options that match the search.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed. Or AdCrunch cannot use the \`cursor\`: it cannot read it, or the cursor belongs to a different query. Then \`error\` is \`invalid\_cursor\`. Send the \`nextCursor\` of the previous page with no change, or omit \`cursor\` to get the first page.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`observe:read\`. \`error\` is \`forbidden\`.
- `404` — Your organization does not own the advertiser in the path, it does not exist, or it is not a Meta ad account. The answer does not tell them apart. \`error\` is \`not\_found\`. AdCrunch asks Meta nothing.
- `409` — This advertiser has no usable connection to Meta. A person must reconnect it.
- `502` — The provider refused the request, or could not answer it. This failure is often transient. Send the request again.

Response example, 200:

```json
{
  "data": [
    {
      "audienceSizeLowerBound": 412000000,
      "audienceSizeUpperBound": 484500000,
      "id": "6003139266461",
      "name": "Yoga",
      "path": [
        "Interests",
        "Fitness and wellness",
        "Yoga"
      ],
      "type": "interest"
    },
    {
      "audienceSizeLowerBound": 18400000,
      "audienceSizeUpperBound": 21700000,
      "id": "6003256093937",
      "name": "Hot yoga",
      "path": [
        "Interests",
        "Additional interests",
        "Hot yoga"
      ],
      "type": "interest"
    }
  ]
}
```
