Skip to content

X Ads line items

List line items (ad groups) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account. Works on your own X Ads account, connected through Get MCP Ads. Needs account id.

Inputs

1 required
Account ID
X Ads account ID selected in SourcesRequired · account_id
Campaign IDs
Comma-separated campaign IDs to scope the line items toOptional · campaign_ids
Count
Number of records to return per page (1-1000)Optional · count
Cursor
Pagination cursor from a previous responseOptional · cursor
Funding instrument IDs
Comma-separated funding instrument IDs to scope the results to (max 200)Optional · funding_instrument_ids
Line item IDs
Comma-separated line item IDs to fetch specific records (max 200)Optional · line_item_ids
Q
Search by line item name (1-255 characters)Optional · q
Sort by
Sort order as attribute-direction, e.g. created_at-asc or updated_at-descOptional · sort_by
With deleted
Include soft-deleted line items in the response (default false)Optional · with_deleted
With draft
Include line items of draft campaigns in the response (default false)Optional · with_draft
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

Pricing

Price
$0.005 per call
Billing
The provider’s price, with no markup. Billed for measured usage.

Call

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

MCP call
cURL command
TypeScript
Tool ID

Alternatives

X Ads reporting

Connect your agent to 2,400+ tools for free

Sign in with Google or GitHub. No card required.