X Ads targeting criteria

Account ID

X Ads account ID selected in SourcesRequired · account_id

Line item IDs

Comma-separated line item IDs to scope the targeting criteria to (the legacy API requires this fi..Required · line_item_ids

Count

Number of records to return per page (1-1000)Optional · count

Cursor

Pagination cursor from a previous responseOptional · cursor

Lang

BCP-47 language code; adds a localized_name response attribute for localizable criteriaOptional · lang

Sort by

Sort order as attribute-direction, e.g. created_at-asc or updated_at-descOptional · sort_by

Targeting criterion IDs

Comma-separated targeting criterion IDs to fetch specific records (max 200)Optional · targeting_criterion_ids

With deleted

Include soft-deleted targeting criteria (default false)Optional · with_deleted

With total count

Include the total_count response attribute (default false; exclusive with cursor)Optional · with_total_count

Workspace ID

Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Price

$0.005 per call

Billing

The provider’s price, with no markup. Billed for measured usage.

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call

Copy

cURL command

Copy

TypeScript

Copy

Tool ID

Copy

• Add an X Ads targeting criterionX Ads$0.05/change
• Remove X Ads targetingX Ads$0.05/change
• Search X Ads targeting interestsX Ads$0.005
• Search X Ads targeting locationsX Ads$0.005
• X Ads targeting criterionX Ads$0.005
• Compare all 6