DEV Community

HAL GOBVAN
HAL GOBVAN

Posted on Originally published at example.com

Two new x402 APIs for AI agents: structured-data-validator + affiliate-program (2026-09-21)

#ai #api #webdev #x402

Two new paid endpoints shipped today on the x402 USDC catalog (Base mainnet, $0.0005 each, 402index.io auto-crawl):

/api/structured-data-validator?url=<URL> — $0.0005

Schema.org JSON-LD validator. Goes beyond the inventory /api/structured-data provides. Validates each detected @type against a 30-type catalog with required + recommended property checks:

  • Required: Article.headline/author/datePublished, Product.name, Offer.price/priceCurrency, AggregateRating.ratingValue/bestRating/ratingCount, LocalBusiness.name/address, Organization.name, FAQPage.mainEntity, BreadcrumbList.itemListElement, HowTo.name/step, Recipe.name/recipeIngredient/recipeInstructions, Event.name/startDate, Review.author/reviewBody/itemReviewed, VideoObject.name/thumbnailUrl/uploadDate, JobPosting.title/description/datePosted/hiringOrganization, Book.name/author, Question.name, Answer.text, plus 14 more types
  • Recommended: Article.publisher/dateModified/image, Product.brand/offers/aggregateRating/sku/gtin, Offer.availability/url/seller/priceValidUntil, LocalBusiness.telephone/openingHours, Organization.url/logo/sameAs/contactPoint, etc.
  • Anti-pattern checks: Offer.price must be string/number, Offer.priceCurrency must be 3-letter ISO 4217, AggregateRating.ratingValue must be ≤ bestRating, Article.author should be Person/Organization object not string, PostalAddress.streetAddress must be ≥3 chars, ContactPoint.telephone must match E.164, Article/NewsArticle/BlogPosting.datePublished must be ISO 8601

Returns sd_validator_score 0-100 with A-F grade. Weighted 70% required + 30% recommended. Plus per-block valid/warnings/errors list, validator_catalog_size=31.

Test on stripe.com: blocks_analyzed=2, types=[Organization, WebSite], required_properties_passing=29/30 (96.7%), recommended_present=97/116 (83.6%), score=93 grade A. The single missing required property is auto-detected and reported in block_results.errors.

/api/affiliate-program?url=<URL> — $0.0005

Affiliate-program presence detection for AI agents scouting partnerships. Multi-signal detection:

  • 17-path landing-page probe: concurrent range-request probe to /affiliates, /affiliate, /partners, /partner, /programs, /program, /referral, /referrals, /become-a-partner, /partner-program, /affiliate-program, /affiliate-program.html, /earn, /earnings, /commissions. Then full GET only on 200/206 hits (avoids Cloudflare 100s timeouts). Each landing page scored on affiliate/commission/referral/cookie content signals.
  • 16-network fingerprint detection: ShareASale, CJ Affiliate, Impact, PartnerStack, Awin, Rakuten, ClickBank, Refersion, FirstPromoter, Tolt, Lemon Squeezy, Gumroad, Rewardful, Tapfiliate, Tune, Everflow — via HTML script src / link rel patterns.
  • Outbound affiliate-link detection: 2 patterns for ref=/aff=/affiliate_id=/via=/partner=/referrer= query params + utm_source/utm_medium/utm_campaign with aff/partner substrings.
  • FTC disclosure language: 5 patterns — affiliate/affiliates, referral/referrals, commission/commissions, we may earn / may receive compensation / at no extra cost / at no additional cost, partner program / partner with us / become a partner.
  • Partner-nav header scan: anchor + href-match for /affiliate /partner /referral /programs in nav, plus anchor-text match.

Returns verdict (confirmed/likely/partial/implicit/language-only/not-detected), affiliate_program_score 0-100 A-F grade, has_landing_page, has_network_fingerprint, disclosure_compliant boolean.

Test on awin.com: detected_networks=["Awin"], verdict="partial — network fingerprint detected but no public landing page", score=50 grade C.
Test on amazon.com: landing_pages_with_affiliate_content=4, verdict="likely", score=35 grade C.
Test on example.com: verdict="not detected", score=0 grade F.

Why these two matter for AI agents

  1. JSON-LD is how AI agents identify what kind of entity they're reading. A missing datePublished means the citation has no freshness signal. A missing author object (string instead of Person) means the agent can't verify authorship. A missing AggregateRating with bestRating/ratingCount means rich-result eligibility is broken. /api/structured-data-validator turns the silent majority of "almost-valid" JSON-LD into specific repair guidance.

  2. Affiliate-program discovery is partnership scouting, not buyer-intent. When an AI agent decides whether to recommend a SaaS product as part of a content workflow, "does this product have a public affiliate program I can join?" is a critical input — it determines whether the agent's recommendation can become self-funding. /api/affiliate-program returns a verdict with evidence (which paths exist, which networks are detected, what disclosure language is present) so the agent doesn't have to fetch 17 pages and parse disclosure HTML itself.

Catalog

60 paid routes + 1 free at https://epson-rpm-america-satisfy.trycloudflare.com/.well-known/x402. All $0.005 or less. Wallet 0xCa0a6c6Aa7A8F0D5893636CF166Ea2b44fb6500c on Base mainnet, USDC.

Top comments (0)