> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Company Advertisement Search > Search for advertisements run by companies matching specified criteria. ## OpenAPI ````yaml en-openapi POST /companies/advertisements/search openapi: 3.0.0 info: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/en/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/en/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Workspace profile information and usage statistics - name: Enrichment description: Enrich people and company records with detailed B2B data - name: Lookalike description: Find companies similar to a given company - name: Search description: Search for people, companies, jobs, news, and advertisements with filters - name: Lookup description: >- Look up detailed information for specific people, companies, jobs, news, advertisements, and technologies - name: LinkedIn description: Look up people and company data via LinkedIn profile URLs - name: Redeem description: Redeem credits to unlock people contact details (single and batch) - name: Channels description: Manage outreach channel templates (create, update, delete, list) - name: Monitor description: Create and manage data monitors with webhooks, statistics, and processing - name: Filters description: >- Retrieve available filter values for search parameters (technologies, locations, verticals, etc.) externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /companies/advertisements/search: post: tags: - Search summary: Search for company advertisements description: Search for advertisements run by companies matching specified criteria. operationId: companies_search_advertisements parameters: [] requestBody: required: true content: application/json: schema: type: object properties: target_locations: $ref: '#/components/schemas/target_locations' exclude_target_locations: $ref: '#/components/schemas/exclude_target_locations' search_terms: $ref: '#/components/schemas/search_terms' headlines: $ref: '#/components/schemas/headlines' filter_conditions: $ref: '#/components/schemas/ads_filter_conditions' start_dates: $ref: '#/components/schemas/start_dates' end_dates: $ref: '#/components/schemas/end_dates' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' source_types: $ref: '#/components/schemas/advertisement_source_types' enrichment_mode: $ref: '#/components/schemas/advertisement_enrichment_mode' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' profile_id: $ref: '#/components/schemas/profile_id' responses: '200': description: Successful response containing company advertisement search details. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: data: pagination: page: 1 per_page: 25 total_entries: 694356 total_pages: 27775 total_display_pages: 250 is_timeout: false advertisements: - advertisement_id: 3af8cb80-9a04-49a8-832d-333961d5f77a advertisement_search_id: 3af8cb80-9a04-49a8-832d-333961d5f77a created_at: '2026-03-03T01:46:35.909Z' last_modified: '2026-03-03T12:46:25.289Z' started_at: '2026-02-25T00:00:00.000Z' ended_at: '2026-03-02T00:00:00.000Z' title: Thuraya-4 Satellite Solutions for Energy source_type: linkedin advertisement_format: Single Image Ad video_url: null image_url: >- https://buckets.pubrio.com/images/public/cL1U5ghYPAy65qc4cu5wtmgzv8P9xJgrofNTwohPWsyT3S5ob2zNp6Jov1nM9aaDRy.jpg carousel_images: null destination_url: >- https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content companies: logo_url: >- https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg domain_search_id: fe3963dc-87a4-4016-8c95-217ea68cd57a company_name: Space42 linkedin_name: space42ai country_code: AE domain: space42.ai - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Filter advertisements to include those targeting specific locations by country code. Use this to find ads that are being shown in specific countries. Combines with `filter_conditions` using OR operator - the advertisement must target at least one of the specified locations. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Filter advertisements to exclude those targeting specific locations by country code. Use this to filter out ads that are being shown in specific countries. When specified in `filter_conditions` with operator 'or', the advertisement must not target any of the excluded locations. search_terms: type: array items: type: string example: - pubrio description: A list of strings over which we want to filter the results. headlines: type: array items: type: string example: - ASUS - iPhone description: A list of headlines to filter search results. ads_filter_conditions: type: array items: type: object properties: key: type: string enum: - target_locations - exclude_target_locations example: exclude_target_locations description: The filter key specifying which property to apply the operator to. operator: type: string enum: - or - and example: or description: >- The logical operator to apply. Use 'or' to match advertisements that include/exclude any of the specified locations, or 'and' to match advertisements that include/exclude all of the specified locations. description: >- Advanced filtering options for advertisement searches. Specify conditions to refine your search results for the ads search endpoint. start_dates: type: array items: type: string format: date example: - '2025-12-01' - '2025-12-01' description: A list of start dates to filter search results. 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. company_locations: type: array items: type: string example: - US - SG - CN description: >- The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information. companies: type: array items: type: string format: uuid description: >- A list of unique identifiers (domain_search_id) used for company and people search operations. 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. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/` is_realtime_enrichment: type: boolean default: false example: true description: >- Opt into realtime enrichment for a single, company-scoped query (filtered by `domain_search_id`, `domains`, or `linkedin_urls`). When the initial search returns zero results, the endpoint scrapes the source, persists the records, and re-runs the search before responding. Subject to a per-route deadline. advertisement_source_types: type: array items: type: string enum: - linkedin - facebook - google example: - linkedin - facebook description: >- Restricts which advertisement source types are eligible for realtime enrichment. Defaults to all sources when omitted. Only applies when realtime enrichment actually runs — i.e. when `is_realtime_enrichment` or `enrichment_mode: latest` is set. advertisement_enrichment_mode: type: string enum: - default - latest default: default example: latest description: >- Controls realtime enrichment behavior. `default` returns whatever is already in the database, and triggers enrichment only when the result set is empty and `is_realtime_enrichment` is set. `latest` bypasses the cache and forces a re-enrichment pass against the freshest source records on every call — it triggers enrichment on its own without needing any other flag. per_page: type: integer example: 25 description: >- The number of search results that should be returned for each page. Limited the number of results per page improves the endpoint's performance. page: type: integer example: 1 description: The page number of the Pubrio data that you want to retrieve. profile_id: type: integer description: >- Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking. Check out `user details` endpoints under the Profile tab for more information. data: type: object nullable: true description: Response info depends on specific endpoint. responses: general_error: description: >- Bad request. The request was malformed or contained invalid parameters. Check the error code and message for details. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Rate limit exceeded. Too many requests were made in a given time period. Retry after the rate limit window resets. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Internal server error. An unexpected error occurred on the server. Contact support if the error persists. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the [Settings](https://dashboard.pubrio.com/#/settings/) section. in: header ````