# Search for Company Advertisements > Search for Company Advertisements is a paid API for AI agents from agents.pubrio.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-11). Search and filter advertisements run by companies across platforms like LinkedIn, Facebook, Google, TikTok, and Apple, with filters for format, date range, and headlines. ## Facts - Endpoint: POST https://agents.pubrio.com/companies/advertisements/search?utm_source=zero.xyz - Price: price unknown - Payment: MPP - Status: unknown - Last checked: 2026-10-11 - Activations on Zero: 0 - Provider: agents.pubrio.com - Website: https://agents.pubrio.com - Canonical page: https://www.zero.xyz/c/agents-pubrio-com-search-for-company-advertisements-2f77b8e5 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VR0Q_C8PyTPOD_HWB6gb4 Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability agents-pubrio-com-search-for-company-advertisements-2f77b8e5 -d '' ``` Example prompt: Search Pubrio for all LinkedIn and Facebook video and image ads currently running by Stripe — show me 25 results starting from page 1. ## When to prefer this Use this endpoint when you need to search across multiple companies' advertisements with flexible filtering by platform, format, date range, or headline keyword. Prefer this over the single-company advertisement lookup when you don't already have a specific advertisement search ID, or when you want to compare advertising activity across multiple companies simultaneously. Best suited for competitive intelligence, market research, and monitoring campaigns at scale. ## Known failure modes - HTTP 416 if page exceeds subscription's max_search_page limit - HTTP 416 with code 41613 if per_page exceeds subscription's max_search_per_page - Empty result set if no ads match the specified filters or company identifiers - Timeout indicated by is_timeout: true in pagination, with partial results - Invalid UUID format for companies array returns validation error - Unsupported source_type or advertisement_format enum value returns error ## How this service works Search advertisements run by companies. See the [Advertisement Search guide](/en/developer-guides/search/advertisement-search). ## Output Returns a paginated list of advertisements with fields including ad title, start/end dates, source platform, format type, and associated company details (name, domain, logo URL, LinkedIn slug, country code). Pagination metadata includes total entries, estimated counts, timeout flags, and page limits based on the subscription plan. ## Request schema (JSON Schema) ```json { "type": "object", "properties": { "page": { "type": "integer", "default": 1, "example": 1, "description": "Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**." }, "query": { "type": "string" }, "domains": { "type": "array", "items": { "type": "string" }, "example": [ "pubrio.com" ], "description": "List of company domains used for company and people search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing." }, "filters": { "type": "object", "properties": { "source_types": { "type": "array", "items": { "enum": [ "linkedin", "facebook", "google", "tiktok", "apple" ], "type": "string" } }, "advertisement_formats": { "type": "array", "items": { "enum": [ "image", "video", "text", "carousel", "dynamic_product", "document", "message", "event", "article", "spotlight", "follow", "job", "engagement", "other" ], "type": "string" } } } }, "per_page": { "type": "integer", "default": 25, "example": 25, "maximum": 25, "description": "Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set." }, "companies": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "A list of unique identifiers (domain_search_id) used for company and people search operations." }, "end_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "example": [ "2025-12-25", "2025-12-25" ], "description": "A list of end dates to filter search results." }, "headlines": { "type": "array", "items": { "type": "string" }, "example": [ "ASUS", "iPhone" ], "description": "A list of headlines to filter search results." }, "created_at": { … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "page": { "type": "integer", "description": "Current page number." }, "per_page": { "type": "integer", "description": "Records per page." }, "is_timeout": { "type": "boolean", "description": "`true` when the search ran out of time. `total_entries` then only counts the rows returned so far, and an empty page means the search did not finish, not that nothing matched." }, "total_pages": { "type": "integer", "description": "`total_entries` divided by `per_page`." }, "is_estimated": { "type": "boolean", "description": "`true` when `total_entries` is an estimate rather than an exact count. Do not use an estimated total to decide when to stop paging; stop when a page returns fewer rows than `per_page`." }, "total_entries": { "type": "integer", "description": "Total matching records. An estimate when `is_estimated` is `true`." }, "total_display_pages": { "type": "integer", "description": "Page count for this result, capped by your plan's `max_display_search_page`." } }, "description": "Pagination for the result set." }, "advertisements": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "nullable": true, "description": "Headline or ad title." }, "ended_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When the ad stopped running; `null` while it is still running." }, "companies": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain, normalised (`stripe.com`)." }, "logo_url": { "type": "string", "nullable": true, "description": "Company logo URL." }, "company_url": { "type": "string", "nullable": true, "description": "Company website URL." }, "company_name": { "type": "string", "description": "Company name." }, "country_code": { "type": "string", "nullable": true, "de … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-pubrio-com-search-for-company-advertisements-2f77b8e5/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agents.pubrio.com](https://www.zero.xyz/host/agents.pubrio.com/llms.txt)