> ## Documentation Index > Fetch the complete documentation index at: https://docs.stairoids.com/llms.txt > Use this file to discover all available pages before exploring further. # Top engaged ICP companies > ICP-matched companies with the highest recent ad engagement. ## OpenAPI ````yaml https://app.stairoids.com/api/docs/public get /public/v1/ads/company-engagement/top-icp openapi: 3.0.1 info: title: Stairoids API description: The Next Generation API version: '1.0' servers: - url: http://app.stairoids.com/api description: Generated server url security: - ApiKeyAuth: [] tags: - name: Public API - Funnel description: Funnel stages, distribution, and pipeline trend metrics. - name: Public API - Attribution description: Traffic sources, campaigns, and the accounts they drove. - name: Public API - Lead Scores description: Signal details and per-person scores. - name: Public API - Reference description: Your ICPs, personas, labels, account lists, and signal categories. - name: Public API - Activity description: Per-person and general (cross-company) signal feeds. - name: Public API - LinkedIn Ads description: LinkedIn ad campaigns, posts, likes, and company engagement. - name: Public API - Companies description: Search, look up, and read activity for scored companies. - name: Public API - Opportunities description: Your best outreach opportunities right now. paths: /public/v1/ads/company-engagement/top-icp: get: tags: - Public API - LinkedIn Ads summary: Top engaged ICP companies description: ICP-matched companies with the highest recent ad engagement. operationId: getPublicTopEngagedIcpCompanies parameters: - name: limit in: query required: false schema: type: integer format: int32 default: 3 responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/PublicCompanyEngagementDTO' '400': description: Bad Request content: '*/*': schema: $ref: '#/components/schemas/CustomError' '402': description: Payment Required content: '*/*': schema: $ref: '#/components/schemas/PlanLimitError' '403': description: Forbidden content: '*/*': schema: $ref: '#/components/schemas/AgencyLimitError' '500': description: Internal Server Error content: '*/*': schema: $ref: '#/components/schemas/CustomError' components: schemas: PublicCompanyEngagementDTO: type: object properties: company: $ref: '#/components/schemas/PublicCompanyDTO' engagementLevel: type: string description: Engagement level bucket. example: HIGH paidClicks: type: integer description: Paid clicks. format: int32 example: 12 paidEngagements: type: integer description: Paid engagements. format: int32 example: 34 organicEngagements: type: integer description: Organic engagements. format: int32 example: 8 organicImpressions: type: integer description: Organic impressions. format: int32 example: 540 paidImpressions: type: integer description: Paid impressions. format: int32 example: 2100 totalInteractions: type: integer description: Total interactions counted. format: int32 example: 46 lastInteractionTimestamp: type: integer description: Last interaction time, epoch millis. format: int64 example: 1719500000000 description: A company's LinkedIn ad engagement, with score and funnel context. CustomError: type: object properties: errorType: type: string enum: - EMAIL_ALREADY_EXISTS - INVALID_EMAIL - UNAUTHORIZED - UNEXPECTED_ERROR - WRONG_PASSWORD - STILL_GENERATING - MISSING_HEADERS - USER_NOT_FOUND - WEAK_PASSWORD - VALIDATION_ERROR - NOT_FOUND - PLAN_LIMIT_EXCEEDED - FEATURE_NOT_AVAILABLE - PAYMENT_ERROR - ACTIVE_SUBSCRIPTION_EXISTS - AGENCY_LIMIT_EXCEEDED - PAYMENT_METHOD_REQUIRED - BILLED_BY_AGENCY - PAYMENT_AUTHENTICATION_REQUIRED - PLAN_BELOW_RECOMMENDED - TRIAL_NOT_ELIGIBLE PlanLimitError: type: object properties: errorType: type: string enum: - EMAIL_ALREADY_EXISTS - INVALID_EMAIL - UNAUTHORIZED - UNEXPECTED_ERROR - WRONG_PASSWORD - STILL_GENERATING - MISSING_HEADERS - USER_NOT_FOUND - WEAK_PASSWORD - VALIDATION_ERROR - NOT_FOUND - PLAN_LIMIT_EXCEEDED - FEATURE_NOT_AVAILABLE - PAYMENT_ERROR - ACTIVE_SUBSCRIPTION_EXISTS - AGENCY_LIMIT_EXCEEDED - PAYMENT_METHOD_REQUIRED - BILLED_BY_AGENCY - PAYMENT_AUTHENTICATION_REQUIRED - PLAN_BELOW_RECOMMENDED - TRIAL_NOT_ELIGIBLE category: type: string currentUsage: type: integer format: int32 limit: type: integer format: int32 addOnSlug: type: string planSlug: type: string addOnPriceMonthly: type: integer format: int32 upgradePlanSlug: type: string upgradePlanName: type: string upgradePlanPriceMonthly: type: integer format: int32 AgencyLimitError: type: object properties: errorType: type: string enum: - EMAIL_ALREADY_EXISTS - INVALID_EMAIL - UNAUTHORIZED - UNEXPECTED_ERROR - WRONG_PASSWORD - STILL_GENERATING - MISSING_HEADERS - USER_NOT_FOUND - WEAK_PASSWORD - VALIDATION_ERROR - NOT_FOUND - PLAN_LIMIT_EXCEEDED - FEATURE_NOT_AVAILABLE - PAYMENT_ERROR - ACTIVE_SUBSCRIPTION_EXISTS - AGENCY_LIMIT_EXCEEDED - PAYMENT_METHOD_REQUIRED - BILLED_BY_AGENCY - PAYMENT_AUTHENTICATION_REQUIRED - PLAN_BELOW_RECOMMENDED - TRIAL_NOT_ELIGIBLE category: type: string currentUsage: type: integer format: int32 limit: type: integer format: int32 PublicCompanyDTO: type: object properties: companyId: type: integer description: Company id. Use with GET /public/v1/companies/{companyId}. format: int64 example: 4521 name: type: string description: Company name. example: Acme Corp domain: type: string description: Primary domain. example: acme.com industry: type: string description: Industry. example: Software country: type: string description: Country. example: Netherlands city: type: string description: City. example: Amsterdam employeeCount: type: integer description: Employee count, if known. format: int32 example: 250 companySize: type: string description: LinkedIn-reported employee size bucket, if known. nullable: true example: 201-500 linkedInUrl: type: string description: LinkedIn company URL. example: https://www.linkedin.com/company/acme totalScore: type: integer description: Total intent / lead score (higher = hotter). format: int32 example: 87 icpMatched: type: boolean description: Whether the company currently matches one of your ICPs. example: true icpId: type: integer description: Matched ICP id, if any. format: int64 nullable: true example: 7 icpName: type: string description: Matched ICP name, if any. nullable: true example: Mid-market SaaS rankedLeadScoreId: type: integer description: Ranked-lead-score row id (the lead-score record for this company). format: int64 example: 55231 logoUrl: type: string description: Company logo URL. nullable: true funnelStageId: type: integer description: Current funnel stage id. format: int64 nullable: true example: 12 funnelStage: type: string description: Current funnel stage name. nullable: true example: Hot labels: type: array description: Labels applied to this company. items: $ref: '#/components/schemas/PublicLabelDTO' latestActivityTimestamp: type: integer description: Last activity timestamp, epoch millis. format: int64 nullable: true example: 1719500000000 description: A company in your pipeline, with its current intent / lead score. PublicLabelDTO: type: object properties: id: type: integer description: Label id. format: int64 example: 5 name: type: string description: Label name. example: Strategic color: type: string description: Hex color. example: '#73d89c' userGenerated: type: boolean description: True if user-created, false if system-generated. example: true description: A label that can be applied to companies. securitySchemes: ApiKeyAuth: type: apiKey description: >- Your organization's public API key. Manage it at GET /api/user/public-api-key. name: X-Api-Key in: header ````