superagnt-com SEO: Technology API

openapi: 3.2.0
info:
  title: 'superagnt SEO: Technology API'
  description: Unified API for social media data. Access LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook through a single API key.
  version: 1.0.0
  contact:
    name: superagnt
    url: https://superagnt.com
servers:
- url: https://api.superagnt.com
  description: superagnt API
security:
- ApiKeyAuth: []
tags:
- name: 'SEO: Technology'
  description: What technologies a website runs, and which sites run a technology.
paths:
  /v1/data/seo/tech-stack:
    post:
      operationId: tech_stack
      summary: Technologies a website runs
      x-agnt-permission: act
      description: 'Returns the technologies detected on a domain: CMS, analytics, marketing tools, payment providers, frameworks, hosting. One domain per call. Use it to qualify a prospect (''do they run Shopify?'') or profile a competitor''s stack.'
      tags:
      - 'SEO: Technology'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - target
              properties:
                target:
                  type: string
                  description: Domain to inspect, no protocol.
            example:
              target: example.com
      responses:
        '200':
          description: Detected technology groups and names in `result[0].items`.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request or upstream task error.
        '401':
          description: Unauthorized.
        '429':
          description: Too many requests.
        5XX:
          description: Upstream error.
      security:
      - ApiKeyAuth: []
  /v1/data/seo/tech-search:
    post:
      operationId: tech_search
      summary: Find websites by technology
      x-agnt-permission: act
      description: 'Returns websites that run the given technologies (e.g. every site on Shopify plus Klaviyo), with domain rank, country and last-seen data. Turns a tech stack into a prospect list in one call. The per-row cost here is roughly 10x the keyword endpoints, so keep `limit` tight: 100 rows is a meaningful list, 1000 is an expensive pull.'
      tags:
      - 'SEO: Technology'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - technologies
              properties:
                technologies:
                  type: array
                  items:
                    type: string
                  minItems: 1
                  description: Technology names the sites must run, e.g. ["Shopify", "Klaviyo"]. Multiple entries intersect.
                limit:
                  type: integer
                  minimum: 1
                  maximum: 1000
                  default: 100
                  description: Max domains to return. Default 100. Per-row cost is high; raise deliberately.
                offset:
                  type: integer
                  minimum: 0
                  description: Pagination offset.
                filters:
                  type: array
                  items: {}
                  description: Optional filter expression, e.g. [["country_iso_code", "=", "US"]].
                order_by:
                  type: array
                  items:
                    type: string
                  description: Sort rules, e.g. ["domain_rank,desc"].
            example:
              technologies:
              - Shopify
              limit: 100
              filters:
              - - country_iso_code
                - '='
                - US
      responses:
        '200':
          description: Matching domains with rank and geography in `result[0].items`.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request or upstream task error.
        '401':
          description: Unauthorized.
        '429':
          description: Too many requests.
        5XX:
          description: Upstream error.
      security:
      - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...'