AvidiaSEO — SEO Content Optimization

What AvidiaSEO Does

AvidiaSEO analyzes the extracted product data and generated descriptions to produce search-optimized metadata for every product. It generates title tags, meta descriptions, H1 headings, and schema.org structured data markup — all grounded in the actual product content rather than generic templates.

Every output is accompanied by a quality score (0–100) with specific recommendations for improvement. You can run AvidiaSEO on individual products, selected batches, or your entire catalog in one bulk job.

How SEO Scoring Works

Each product receives an SEO score from 0 to 100 based on the following weighted factors:

Title Tag Optimization

The title tag is the most important on-page SEO element. AvidiaSEO generates title tags that follow the format:

[Primary Keyword] — [Brand] [Model] | [Category Modifier]

Examples:
"N95 Respirator — 3M 8210 | Box of 20, NIOSH-Approved"
"18V Cordless Drill — Bosch GSB 18V-755 | Brushless Combi"
"Surgical Gloves — Medline SensiCare | Powder-Free, Size M"

Meta Description

The meta description is the summary text that appears below your title in search results. While not a direct ranking factor, it significantly impacts click-through rate. AvidiaSEO generates meta descriptions that:

• ✓Stay within 150–160 characters (the sweet spot before Google truncates)
• ✓Include the primary keyword naturally in the first 100 characters
• ✓End with a soft call to action ("Shop now", "Order today", "View full specs")
• ✓Reference a key differentiating spec (e.g., "NIOSH-approved", "18V Li-ion", "powder-free")

Example: "Buy the 3M N95 8210 Respirator — NIOSH-approved with ≥95% filtration. Box of 20, flat-fold design for all-day comfort. Ships same day." (155 characters)

H1 vs. Title Tag

Your H1 (page heading) and title tag serve different purposes and should not be identical:

Schema.org Structured Data

AvidiaSEO generates valid JSON-LD markup for Product, Offer, and where available, AggregateRating schemas. This enables rich search results (star ratings, price, availability) in Google Shopping and organic SERPs.

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "3M N95 Particulate Respirator 8210, 20/Box",
  "brand": { "@type": "Brand", "name": "3M" },
  "sku": "8210",
  "gtin": "00051131070141",
  "description": "NIOSH-approved N95 respirator with ≥95% filtration efficiency...",
  "image": ["https://cdn.3m.com/3M/en_US/p/d/v000057867/img/main.jpg"],
  "offers": {
    "@type": "Offer",
    "priceCurrency": "USD",
    "price": "24.99",
    "availability": "https://schema.org/InStock",
    "seller": { "@type": "Organization", "name": "Your Store" }
  }
}

The generated schema is available in the SEO panel under Structured Data. You can copy the JSON-LD block directly or use the Shopify/BigCommerce integration to inject it automatically.

Common SEO Issues and Fixes

SEO Audit

The SEO Audit at /dashboard/audit scans all products in your catalog and identifies:

• Products with no SEO data (never run through AvidiaSEO)
• Products with scores below your configured threshold (default: 70)
• Duplicate title tags across products
• Missing or invalid schema markup
• Meta descriptions over 160 characters or under 100 characters
• Products with title tags identical to their H1

From the Audit view, you can select flagged products and re-run AvidiaSEO in bulk to resolve issues automatically.

Bulk SEO Processing

To run AvidiaSEO across your entire catalog (or a filtered subset):

1. Go to Dashboard → Products and filter to the products you want to optimize.
2. Select all (or a selection) using the checkboxes.
3. Click Bulk Actions → Run SEO.
4. Confirm the credit cost and start the job. Processing runs in the background.

AvidiaSEO costs 1 SEO credit per product per run. Running SEO on 500 products costs 500 SEO credits.

API: Run SEO Optimization

// Run SEO on an existing ingestion
POST https://app.avidiatech.com/api/v1/seo
Authorization: Bearer <your-api-key>

{
  "ingestion_id": "ing_01HX4K2QZRP7W9VMBGT3DENF8",
  "options": {
    "include_schema": true,
    "category_keywords": ["N95", "respirator", "PPE", "NIOSH"]
  }
}

// Response
{
  "id": "seo_01HX5MNQR2VP8XWBCJT5GAEF1",
  "title": "N95 Respirator — 3M 8210 | NIOSH-Approved, 20/Box",
  "meta_description": "Buy the 3M N95 8210 Respirator — NIOSH-approved with ≥95% filtration. Box of 20, flat-fold design. Ships same day.",
  "h1": "3M N95 Particulate Respirator 8210 (Box of 20)",
  "schema": { "@context": "https://schema.org/", "@type": "Product", "..." },
  "score": 91,
  "recommendations": []
}

// Run SEO directly on ingestion
POST https://app.avidiatech.com/api/v1/ingest/ing_01HX4K2QZRP7W9VMBGT3DENF8/seo

Pushing SEO Data to Your Store

Once SEO data is generated, push it to your platform:

• Shopify: AvidiaTech writes the title tag to Shopify's metafields_global_title_tag and meta description to metafields_global_description_tag. Schema is injected via a theme snippet (setup instructions in the Shopify integration guide).
• BigCommerce: Title and meta description are written to the product's Page Title and Meta Description fields via the BigCommerce Management API.

See the full Integrations guide for setup instructions.