> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ad Server | Full API Integration

> Every feature and capacity we deliver can be used through our APIs

export const IntegrationsCard1A = () => {
  return <>
      <style>{`
        .integrations-card-1a {
          display: flex;
          flex-direction: column;
          background-color: #f0f2f4;
          border: 1px solid rgba(0, 0, 0, 0.08);
          border-radius: 12px;
          padding: 1.25rem 1.5rem;
          gap: 0.25rem;
          color: #25253b;
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);
          transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
          margin-top: 2rem;
        }

        .integrations-card-1a:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a {
          background-color: #25253b;
          color: #f6f8fa;
          border-color: rgba(255, 255, 255, 0.08);
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
        }

        .dark .integrations-card-1a:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

        .integrations-card-1a-avatar-row {
          display: flex;
          margin-left: 14px;
          flex-wrap: nowrap;
        }

        .integrations-card-1a-avatar {
          width: 44px;
          height: 44px;
          border-radius: 50%;
          border: 2px solid #f0f2f4;
          margin-left: -14px;
          object-fit: cover;
          box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);
          pointer-events: none;
          cursor: default;
        }

        .dark .integrations-card-1a-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a h2 {
          margin: 0;
          line-height: 1.25;
          font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);
          font-weight: 700;
          letter-spacing: -0.025em;
          color: #111827;
        }

        .dark .integrations-card-1a h2 {
          color: #f9fafb;
        }

        .integrations-card-1a-subtitle {
          font-size: 0.9375rem;
          font-weight: 500;
          line-height: 1.5;
          color: #4b5563;
          margin: 0;
        }

        .dark .integrations-card-1a-subtitle {
          color: #d1d5db;
        }

        .integrations-card-1a p {
          margin: 0;
          line-height: 1.5;
          font-size: 0.875rem;
          color: #374151;
        }

        .dark .integrations-card-1a p {
          color: #d1d5db;
        }

        .integrations-card-1a a {
          color: #0500ff;
          text-decoration: none;
          font-weight: 500;
          transition: color 0.15s ease;
        }

        .integrations-card-1a a:hover {
          color: #0400cc;
        }

        .dark .integrations-card-1a a {
          color: #8280ff;
        }

        .dark .integrations-card-1a a:hover {
          color: #a19fff;
        }

        @media (max-width: 640px) {
          .integrations-card-1a-avatar {
            width: 38px;
            height: 38px;
            margin-left: -12px;
          }

          .integrations-card-1a-avatar-row {
            margin-left: 12px;
          }
        }

        @media (min-width: 1280px) {
          .integrations-card-1a p {
            font-size: 0.6875rem;
            line-height: 1.4;
            letter-spacing: -0.01em;
          }

          .integrations-card-1a h2 {
            font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);
          }

          .integrations-card-1a-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a">
        <div className="integrations-card-1a-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="Agustin - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="Amelia - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="Bernardita - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="Borumy - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="Felipe - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/gui.webp" alt="Gui - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="Javiera - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/linn.webp" alt="Linn - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="Marcio - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="Mateus - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/max.webp" alt="Max - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="Rodrigo - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
        </div>

        <h2>Need help with your Topsort integration?</h2>

        <p className="integrations-card-1a-subtitle">
          Talk to us, the integrations engineering team.
        </p>

        <p>
          Reach us via <strong>your dedicated messaging channel</strong> or at{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          If you're not a customer yet,{" "}
          <a href="https://www.topsort.com/book-a-demo">book a demo</a> with our
          sales team instead.
        </p>
      </div>
    </>;
};

**Ad Server** is your complete API-first advertising solution, designed for businesses that need full control and customization. Every feature and capability Topsort offers is accessible through our comprehensive API suite, giving you maximum flexibility to build exactly what you need.

With Ad Server, you have complete control over auction logic, ranking algorithms, event tracking, and reporting. Perfect for companies with in-house development teams who want to deeply integrate advertising into their platform's unique architecture and workflows.

## Who Is This For?

Ad Server is ideal for:

* **Enterprises** with in-house engineering teams and custom requirements
* **Technical teams** needing full control over ad logic and ranking algorithms
* **Businesses** requiring deep integration with proprietary systems
* **Platforms** with unique auction mechanics or custom workflows

<Note>
  **Want a faster setup?** If you need quick deployment without extensive API integration, explore [Ad Platform](/en/ad-platform) instead.
</Note>

## Key Benefits

<CardGroup cols={2}>
  <Card title="Complete Flexibility" icon="sliders">
    Full control over every aspect
  </Card>

  <Card title="Custom Logic" icon="code">
    Build your own ranking algorithms
  </Card>

  <Card title="Deep Integration" icon="plug">
    Integrate with proprietary systems
  </Card>

  <Card title="Advanced Features" icon="sparkles">
    Access to all API capabilities
  </Card>
</CardGroup>

## Core APIs

Build your advertising platform using three foundational APIs:

### Catalog API

Keep your products, categories, and vendors synchronized with Topsort.

<CardGroup cols={2}>
  <Card title="Products API" icon="box" href="/en/ad-server/catalog/products">
    Manage product catalog data
  </Card>

  <Card title="Vendors API" icon="store" href="/en/ad-server/catalog/vendors">
    Manage advertiser accounts
  </Card>

  <Card title="Categories API" icon="folder-tree" href="/en/ad-server/catalog/categories">
    Organize product taxonomy
  </Card>

  <Card title="Sync Strategies" icon="arrows-rotate" href="/en/ad-server/catalog/sync">
    Keep catalog data current
  </Card>
</CardGroup>

### Auctions API

Trigger real-time bidding and retrieve winners for sponsored products and banners.

<CardGroup cols={2}>
  <Card title="Auctions Overview" icon="gavel" href="/en/ad-server/auctions">
    Real-time bidding mechanics
  </Card>

  <Card title="Promoted Products" icon="tag" href="/en/ad-server/auctions/promoted-products">
    Sponsored product listings
  </Card>

  <Card title="Promoted Banners" icon="rectangle-ad" href="/en/ad-server/auctions/promoted-banners">
    Banner ad auctions
  </Card>

  <Card title="Auction Responses" icon="list" href="/en/ad-server/auctions/responses">
    Handle auction results
  </Card>
</CardGroup>

### Events API

Track impressions, clicks, and purchases to enable optimization, reporting, and attribution.

<CardGroup cols={2}>
  <Card title="Events Overview" icon="chart-line" href="/en/ad-server/events">
    Event tracking fundamentals
  </Card>

  <Card title="Impressions" icon="eye" href="/en/ad-server/events/impressions">
    Track ad views
  </Card>

  <Card title="Clicks" icon="hand-pointer" href="/en/ad-server/events/clicks">
    Track ad interactions
  </Card>

  <Card title="Purchases" icon="cart-shopping" href="/en/ad-server/events/purchases">
    Track conversions and revenue
  </Card>
</CardGroup>

## Getting Started

New to Ad Server? Follow these steps:

1. **Set up your environment** - Get API credentials and configure authentication
2. **Sync your catalog** - Use the Catalog API to import products, vendors, and categories
3. **Implement auctions** - Integrate auction calls into your search and browse flows
4. **Track events** - Send impression, click, and purchase events to close the loop
5. **Test and optimize** - Monitor performance and refine your implementation

<Tip>
  Start with [Authentication](/en/ad-server/authentication) to get your API credentials, then move to [Catalog API](/en/ad-server/catalog) to sync your products.
</Tip>

## Advanced Capabilities

Once you have the basics working, explore advanced features:

* **Custom ranking algorithms** - Implement your own logic for ad placement
* **A/B testing** - Run experiments on auction parameters and ranking strategies
* **Custom attribution models** - Build attribution logic that fits your business
* **Real-time reporting** - Create custom dashboards using our analytics endpoints
* **Multi-region deployments** - Scale across geographic regions

## Want Quick Setup Instead?

While Ad Server provides maximum flexibility and control, some businesses prefer a faster path:

* **Pre-built UI components** instead of custom development
* **Managed campaign tools** instead of custom workflows
* **Out-of-box reporting** instead of custom dashboards
* **Low-code integration** instead of full API implementation

If this describes your needs, explore [Ad Platform](/en/ad-platform) for pre-built tools and faster deployment.

<IntegrationsCard1A />
