OXIRANKER DEVELOPER DOCS

OxiRanker Documentation

A clean documentation center for connecting your website to OxiRanker services. Start with WordPress integration or API integration, then follow the guide step by step.

Official documentationFull-feature V1For site owners, developers and integration teams

Documentation menu

Choose a guide from the menu. This page is the main documentation center for OxiRanker.

WordPress service

Connect your website with the OxiRanker WordPress plugin, receive generated articles and publish them as WordPress posts.

Domain

Verified

Content

Ready

WordPress

Plugin

Important storage notice

OxiRanker is not permanent hosting for the destination website

OxiRanker does not provide a permanent hosting guarantee for the destination website's content, images or exported files. OxiRanker is not a user-content hosting service, and generated content, cover images, Open Graph images or output files may not remain on OxiRanker infrastructure for more than 90 days.

Therefore, after receiving the output, the destination website must store the final article, images, SEO data, Open Graph data and Schema data in its own database, server, storage or CDN, and must not rely on OxiRanker URLs for public display.

Training video

Connection training video

Use this video as a visual walkthrough before connecting WordPress or implementing the API integration.

Download the OxiRanker WordPress plugin

Download the WordPress plugin file and install it from the Upload Plugin section in your WordPress dashboard.

Plugin file

oxiranker.zip

Download plugin

Download the plugin, upload it in WordPress, activate it, then connect it with your Domain ID and Connect Token.

STEP 01

Register and create a domain in OxiRanker

First, register in OxiRanker, sign in to your account and click Add Domain from the Domains section.

Correct domain format

In the Domain name field, enter only the root domain. The address must not include http, https or www.

example.com

Wrong formats

Do not enter these formats in the domain field.

https://example.com
http://example.com
www.example.com

After creating the domain

If the domain format is valid, OxiRanker creates the domain and takes you to the domain ownership verification step.

STEP 02

Verify domain ownership

In this step, you must prove that the domain belongs to you or that you have access to manage it.

DNS TXT

Recommended

Add a TXT record to the domain DNS. For Cloudflare, this is usually the simplest method.

DNS Name:
_yourdomain-verification.example.com

TXT Value:
acb1****29803

HTTP File

Place a text file in the .well-known path of your website so OxiRanker can verify it.

File URL:
https://example.com/.well-known/yourdomain-verification.txt

File Content:
220daaa37****42730f27

Meta Tag

Place a meta tag inside the head section of your website homepage.

<meta name="yourdomain-verification" content="190208d****d275b65" />

Important DNS note

After adding the DNS record, especially in Cloudflare, you may need to wait 2 to 3 minutes. Then click Confirm on the same OxiRanker page.

Verification token lifetime

Domain verification values have a time limit. Currently, verification values are usually valid for 1440 minutes.

STEP 03

Receive free tokens after verifying the first domain

After verifying the first domain, OxiRanker adds 1000 free tokens to your account for initial testing.

Only for the first domain

This gift is only added for the first verified domain and is not added again for later domains.

STEP 04

Configure languages and Blog URL

In the Blog URLs section, define whether your website is single-language or multilingual and which languages should be used for generated articles.

Choose languages

OxiRanker supports 24 languages. You can choose one or multiple languages based on your website structure.

Enter Blog URL

For each language, enter the blog URL for that language. If your website is multilingual, enter each language path separately.

https://example.com/fa/blog
https://example.com/en/blog

URL structure

If your website has a different structure, enter the real blog URL of your website. The important point is that the final URL must be the path where articles should be published.

STEP 05

Add keywords for each language

In the Keywords tab, add at least 3 and up to 50 keywords for each language.

Main rule

Keywords for each language must be entered in the same language. If the article language is English, the keywords must also be English.

How to add keywords

After typing each keyword, press Enter to add it. After completing all keywords, click Save.

Common mistake

If you enter Turkish keywords for the English language, Turkish phrases may appear in English content. The keyword language must match the article language.

STEP 06

Complete the domain Article Profile

Article Profile tells OxiRanker what your brand is, who it writes for, what tone it should use and which topics it should avoid.

Industry

Defines the market or business category. Example: real estate consulting and property buying and selling in Dubai.

Business description

Explains what the business sells, who it serves, how it works and what makes it different.

Audience

Defines who the content should speak to. Each audience can be saved separately.

Tone

Controls the style and voice of generated content, such as formal, educational, simple, technical or sales-oriented.

Content goal

Defines what the articles should achieve, such as attracting customers, increasing traffic or educating users.

Forbidden topics

Anything the brand should not talk about or should not be associated with is entered here.

Optional CTA

CTA means the action you want the reader to take after reading the article. If you are not sure what text is suitable, it is better to leave this field empty.

Multilingual profile

If your website is multilingual, you only need to complete the profile in one language. OxiRanker can prepare the required versions for other languages based on the same profile.

STEP 07

Internal and external linking

OxiRanker can intelligently apply internal and external links inside articles.

Internal links

This option is enabled by default and it is better to keep it enabled. Internal linking helps search engines better understand the content structure of your website.

In the first article, internal links are usually not created because there is no previous article yet. From the second article onward, the system can perform internal linking.

External links

External links are added to official and trusted sources and are marked as nofollow so SEO authority is not unintentionally transferred.

STEP 08

Check profile quality with AI

After completing the Article Profile, OxiRanker reviews the profile quality.

85+

Minimum score required to save

Excellent score commonly reached after improvements

Professional suggestions for each field

If the score is below 85

The system does not allow final saving and shows explanations and improvement suggestions for each problematic field. You can apply the suggestions and save again.

STEP 09

Connect Telegram for article summaries

After successfully saving the profile, you can enable sending article summaries to a Telegram channel.

Add the bot

Add @Oxiranker_Bot to your Telegram channel and make it an Admin.

Enter the channel username

Enter the channel name with @. Example: @my_channel

Enable summary delivery

After registering a valid channel, enable article summary delivery.

Telegram benefit

If enabled, after content generation, the article summary is sent to the Telegram channel with the image and link. This can strengthen traffic paths to your website.

STEP 10

Configure the automatic article engine

In the Automatic article generation tab, you can manage the automatic article generation engine.

Smart topic selection

The system uses keywords and Article Profile to select suitable, unique and publishable topics.

Brand-aware generation

Tone, audience, content goal and brand restrictions are respected during article generation.

Scheduled publishing

Monthly capacity is distributed throughout the month so content publishing looks more natural and consistent.

Monthly capacity

7 articles / month
10 articles / month
15 articles / month
30 articles / month

30 articles means almost one article per day. 15 articles means almost every other day. 10 articles means about every two to three days. 7 articles means about every three to four days.

Article length and image

Article length can be Short, Standard or Long. Standard is a balanced choice for most websites.

Article images can be enabled or disabled, and the image theme can be Light or Dark.

STEP 11

Create the first article from Generate

After preparing the domain, open the Generate menu, choose the domain and click New Content or New Article.

Language

Only one language is selected for each content request.

Topic

Write a clear topic. Source URL is optional.

Image

Enable or disable the image and choose Light or Dark theme.

Payment and generation

The cost is deducted from the wallet and article generation starts.

Generation time

Article and image generation usually takes about 2 to 3 minutes. After completion, the article is visible inside OxiRanker.

Source URL

If Source URL is entered, OxiRanker uses it to better understand the topic, but it does not generate copied content. The system is designed to create unique content.

STEP 12

Review Preview, SEO Report and JSON Output

After the article is generated, several important outputs are available for quality review and publishing preparation.

Preview

Shows the article text and generated image. This section is useful for reviewing final quality before publishing.

SEO Report

Shows an understandable SEO report including SEO Score, title, meta description, canonical, keywords, schema, headings, links, images and OpenGraph.

JSON Output

Shows the full article output for technical users, including slug, html_body, schema, image URLs, tags, category, reading time and created/updated timestamps.

Meaning of the outputs

These outputs show that the article is not just plain text. It is structured, SEO-ready content prepared for WordPress, CMS, API and publishing systems.

STEP 13

Connect WordPress and publish articles

In the WordPress Output tab, you can connect your WordPress website to OxiRanker.

Step 1: Install the plugin

Download, install and activate the OxiRanker plugin.

https://oxiranker.com/oxiranker.zip

Installation path in WordPress:

Plugins -> Add New -> Upload Plugin -> oxiranker.zip -> Activate

Step 2: Connect with Token

Copy the Domain ID and Connect Token from the Setup Wizard and enter them in the plugin settings.

DOMAIN ID:
1

CONNECT TOKEN:
wlXQy15WMB****MC1Lb08=

Connect Token has a time limit and is usually active for 30 minutes.

Step 3: Publishing method

After connecting, choose the publishing method.

Publish

Articles are published immediately.

Draft

Articles are created as drafts.

Manual

The user sends the article using the publish button.

Recommendation for initial testing

For initial testing, it is better to set the default post status in the plugin to Draft so the article can be reviewed in WordPress before publishing.

Automatic publishing

If automatic publishing is enabled, articles generated manually or by the automatic engine can be sent to WordPress after they are ready.

STEP 14

Yoast SEO compatibility

If your website uses the Yoast SEO plugin, OxiRanker is compatible with it.

If Yoast is installed

OxiRanker sends SEO data in a way that Yoast can use and render when Yoast exists.

If Yoast is not installed

If Yoast is not installed, the OxiRanker plugin can manage and render the required SEO data itself.

STEP 15

Complete WordPress flow summary

After completing these steps, your WordPress website will be ready to receive articles generated by OxiRanker.

Add a domain

Verify domain ownership

Choose languages and add Blog URL

Add keywords for each language

Complete Article Profile

Configure Telegram if needed

Configure the automatic article engine

Create the first article from Generate

Review Preview and SEO Report

Install the WordPress plugin

Enter Domain ID and Connect Token

Choose publishing method

Publish articles in WordPress