Affiliate Egg integration

Affiliate Egg is a companion plugin that reads product data straight from store websites — no API and no data feed required. With the integration you can connect almost any online store as a Content Egg module and use it like any other module: keyword search, direct URLs, price updates, comparisons, templates and blocks.

• No API required — extract price, image, stock and more directly from the store page.

• Almost any store — connect a supported shop, or any custom domain by its address.

• Custom parsers — order a hand-written parser for stores that need one (see Ordering a custom parser).

• Full Content Egg power — price updates, price comparison, product import, templates and blocks all work with connected stores.

New to the difference between our plugins? Read Content Egg vs Affiliate Egg vs External Importer.

Requirements

• The Affiliate Egg plugin is installed, activated, and has a valid license.

• Affiliate Egg 11.0.0 or newer to connect custom (unregistered) domains.

Connect a store

The "Connect a store" button on the Modules page

1. Go to Content Egg → Modules and click Connect a store in the Affiliate Egg modules section.

2. Enter the shop domain (for example example.com).

3. (Optional) Enter a Search URL to enable keyword search — see Search URL. Leave it empty to work with direct product and category URLs only.

4. Click Connect. You're taken to the new module's settings, and the module is active by default.

The "Connect a store" modal

Add products to a post

Open a post and find the connected store in the Content Egg metabox. There are three ways to add products:

• Direct product URL — paste a product page URL. Recommended: it's the most reliable and uses the fewest requests to the store.

• Category / listing URL — paste a category URL to pull several products from it.

• Keyword search — type a keyword. Requires a Search URL.

Searching a connected store from the post editor

Prefer direct product URLs over keyword search whenever you can — fewer requests to the source site means less chance of being blocked.

Module settings

Open the module's settings page (Content Egg → Modules → [your store]) to configure:

• Affiliate link (Deeplink) — turn direct product links into your affiliate links. You can change this at any time to switch networks. See Deeplink settings.

• Results — how many products a keyword search returns.

• Save images — store product images on your own server.

• Update frequency — how often prices and availability refresh.

Search URL

A Search URL lets a custom domain module search by keyword. To build one:

1. On the store's website, search for any product — say, shoes.

2. Copy the URL from your browser's address bar.

3. Replace your search word with %KEYWORD%.

So a search that looks like this:

https://example.com/search?q=shoes

becomes:

https://example.com/search?q=%KEYWORD%

• If you paste a normal search URL (for example ?q=bike), Content Egg tries to insert %KEYWORD% for you automatically.

• No Search URL? The module still works with direct product and category URLs — only keyword search is unavailable.

Some stores render their search results with JavaScript, which a parser can't read. If keyword search returns nothing, use a direct product URL instead.

Ordering a custom parser

Why you might need one. Custom-domain modules use Affiliate Egg's generic parser, which reads most modern stores. But some shops have unusual markup the generic parser can't understand — when that happens a search shows "No product data found — this shop likely needs a custom parser." A custom parser is hand-written for that specific store, so it reads its products reliably.

Cost: $25 per parser. Each store needs its own parser, and you can use it on any of your sites.

Process:

1. Email us your list of stores through the contact form.

2. Invoice — we review your list and send you an invoice.

3. Creation — it usually takes 1–2 days.

Installation:

• Copy the parser files to your server's /wp-content/affegg-parsers/ directory.

• Custom parsers work exactly like the built-in ones — connect the store the same way as above.

Guarantee: 6 months. If a parser needs corrections during that time, we make them for free.

Troubleshooting

When a search can't return products, Content Egg shows a short explanation in the metabox. Here's what each message means and how to resolve it:

Message	What it means	What to do
Blocked by the site (503 / 403)	The store is blocking automated requests.	Enable a scraping service; slow down price updates; add products gradually.
No product data found — needs a custom parser	The generic parser couldn't read the product page.	Order a custom parser for this store.
No products found — try a direct product URL	Keyword search returned nothing, often a JavaScript search page.	Paste a direct product URL instead.
Keyword search isn't set up / Add a Search URL	No keyword search is configured for this store.	Use a direct URL, or add a Search URL in the module settings.
That URL is for a different store	The URL's domain doesn't match this module.	Enter a URL from the connected store, or a keyword.
The store took too long to respond	The request timed out.	Try again, or enable a scraping service.
Your session has expired	The editor was left open past the login token's lifetime.	Reload the page and search again.

Avoid getting blocked

Affiliate Egg makes a separate HTTP request for each product search and price update. Sites with anti-bot protection or per-IP rate limits can return 503 or 403 errors if you make too many requests.

A block usually lifts after 24 hours. To avoid it in the first place:

• Search by direct product URL instead of keywords (most important).

• Limit price updates — avoid very frequent update schedules.

• Add products gradually — don't import too many at once.

• Use a scraping service for a persistent block — see Extractor settings.

FAQ

Why do I need Affiliate Egg if I have Content Egg?

Not every store with an affiliate program offers a product API — smaller shops especially. Affiliate Egg reads the data directly from the site, so you can promote stores Content Egg doesn't support natively. If a store needs it, we can also build a custom parser for you.

Which stores can I connect?

Almost any online store — supported shops out of the box, and any other domain via the generic parser (Affiliate Egg 11.0.0+). A few stores may need a custom parser.

Direct URL or keyword search — what do you recommend?

Direct product URLs whenever possible. They're more reliable and make fewer requests to the store, which lowers the risk of being blocked.

Amazon is in both plugins — which should I use?

Prefer Content Egg's Amazon module. Amazon's API is fast and stable, while intensive web parsing can get your IP blocked.