WordPress Link Remover API Documentation

WordPress Link Remover API

The WordPress Link Remover API allows you to programmatically remove links from WordPress posts and pages. You can remove internal links, external links, or target specific URLs while preserving the anchor text content.

Features

Selective link removal - Remove only internal or external links
Target specific URLs - Remove only links matching a specific URL
Preserve content - Keep anchor text while removing links
Smart processing - Handles both posts and pages automatically
Rate limiting - Built-in protection against abuse
Request logging - Track API usage and success rates
Secure authentication - Client ID and secret key based authentication

Base URL

https://api.corenexis.com/wordpress/link-remover/V2

Authentication

All API requests require authentication using a client ID and secret key. Additionally, you need WordPress credentials for the target site where you want to remove links.

API Authentication

Contact your API provider to obtain these credentials:

API Credentials

WordPress Authentication

You also need WordPress credentials for the target site:

WordPress Username: A user with edit permissions for posts/pages
WordPress Password: The password for that user
JWT Plugin: WordPress JWT Authentication plugin must be installed

WordPress JWT Plugin Required

Make sure the JWT Authentication for WP REST API plugin is installed and configured on your WordPress site before using this API. click here to verify your credentials.

Rate Limits

API usage is subject to rate limits to ensure fair usage and system stability. Limits are enforced per client ID.

Default Limits

Limit Type	Default Value	Description
Daily Requests	100 requests	Maximum requests per day per client
Rate Limit	2 requests/minute	Maximum requests per minute
Concurrent Requests	1 request	One request at a time per client

Rate Limit Headers

When you hit rate limits, you'll receive a 429 status code with information about when you can retry.

Endpoints

Remove Links

POST https://api.corenexis.com/wordpress/link-remover/V2

This endpoint removes links from a WordPress post or page. You can remove all internal links, all external links, or target a specific URL for removal.

Request Parameters

Parameter	Type	Description
post_url Required	String	The full URL of the WordPress post or page to process
client_id Required	String	Your client ID for authentication
secret_key Required	String	Your secret key for authentication
link_type Required	String	Type of links to remove: `internal` - Remove only internal links `external` - Remove only external links Note: Ignored if targetURL is provided
wordpress_id Required	String	WordPress username with edit permissions
wordpress_pass Required	String	WordPress password for the specified user
targetURL Optional	String	Specific URL to target for removal. When provided, only links matching this URL will be removed, regardless of link_type

Response

A successful response will return a 200 status code and a JSON object with the following properties:

Success Response

{
  "status": "success",
  "website_url": "https://example.com",
  "post_id": 123,
  "link_type": "external",
  "target_url": "https://specific-url.com", // Only present if targetURL was provided
  "total_links_removed": 5,
  "total_links_with_anchor_removed": 2,
  "total_links_only_removed": 3
}

Response Fields

Field	Description
`status`	Response status (success/failed)
`website_url`	The base URL of the WordPress site
`post_id`	WordPress post/page ID that was processed
`link_type`	Type of links that were targeted for removal
`target_url`	Specific URL that was targeted (only if targetURL was provided)
`total_links_removed`	Total number of links removed from the content
`total_links_with_anchor_removed`	Number of links where both link and anchor text were removed
`total_links_only_removed`	Number of links where only the link was removed, keeping anchor text

Link Processing

The API uses intelligent link processing to determine which links to remove and how to handle the anchor text.

Internal vs External Links

The API automatically categorizes links as internal or external based on the domain:

Internal Links

Links pointing to the same domain as the WordPress site
Relative URLs (e.g., /about-us)
Protocol-relative URLs pointing to the same domain
URLs with or without www prefix are considered the same domain

External Links

Links pointing to different domains
All absolute URLs not matching the site domain
Social media links, affiliate links, etc.

Smart Domain Matching

The API automatically handles www prefixes and different protocols when determining if a link is internal or external.

Target Specific URL

When you provide a targetURL parameter, the API will only remove links that match that specific URL, ignoring the link_type parameter.

URL Matching Features

Exact matching: URLs must match exactly
Protocol handling: Handles http/https differences
www normalization: Treats www and non-www as the same
Path matching: Includes path, query parameters, and fragments
Trailing slash handling: Normalizes trailing slashes

Use Case Example

Perfect for removing specific affiliate links, outdated URLs, or links to content that no longer exists.

Anchor Text Handling

The API intelligently handles anchor text based on its content:

Anchor Text Type	Processing Behavior
Same as URL	Entire link including anchor text is removed
Descriptive text	Link is removed but anchor text is preserved
Empty anchor	Entire link is removed

Usage Examples

Here are practical examples of how to use the API for different scenarios.

Remove All External Links

cURL Example

curl -X POST \
  -F "post_url=https://yoursite.com/sample-post" \
  -F "client_id=your_client_id" \
  -F "secret_key=your_secret_key" \
  -F "link_type=external" \
  -F "wordpress_id=your_username" \
  -F "wordpress_pass=your_password" \
  https://api.corenexis.com/wordpress/link-remover/V2

Remove All Internal Links

cURL Example

curl -X POST \
  -F "post_url=https://yoursite.com/sample-post" \
  -F "client_id=your_client_id" \
  -F "secret_key=your_secret_key" \
  -F "link_type=internal" \
  -F "wordpress_id=your_username" \
  -F "wordpress_pass=your_password" \
  https://api.corenexis.com/wordpress/link-remover/V2

Remove Specific URL

cURL Example

curl -X POST \
  -F "post_url=https://yoursite.com/sample-post" \
  -F "client_id=your_client_id" \
  -F "secret_key=your_secret_key" \
  -F "link_type=external" \
  -F "targetURL=https://affiliate-link.com/product" \
  -F "wordpress_id=your_username" \
  -F "wordpress_pass=your_password" \
 https://api.corenexis.com/wordpress/link-remover/V2

Note about targetURL

When targetURL is provided, the link_type parameter is ignored. Only links matching the targetURL will be removed.

Process a WordPress Page

cURL Example

curl -X POST \
  -F "post_url=https://yoursite.com/about-us" \
  -F "client_id=your_client_id" \
  -F "secret_key=your_secret_key" \
  -F "link_type=external" \
  -F "wordpress_id=your_username" \
  -F "wordpress_pass=your_password" \
  https://api.corenexis.com/wordpress/link-remover/V2

Error Handling

The API uses standard HTTP status codes to indicate the success or failure of a request. Here are the common error responses you might encounter:

Status Code	Description	Example Response
400	Bad Request - Missing required fields	`{"status": "failed", "error": "Missing required field: post_url"}`
400	Invalid post URL format	`{"status": "failed", "error": "Invalid post URL format"}`
400	Homepage not allowed	`{"status": "failed", "error": "Homepage not allowed. Please provide a specific post or page URL."}`
400	Invalid link type	`{"status": "failed", "error": "Invalid link_type. Must be 'internal' or 'external'."}`
401	Unauthorized - Invalid API credentials	`{"status": "failed", "error": "Not authorized. Wrong API key."}`
401	WordPress authentication failed	`{"status": "failed", "error": "Failed to authenticate with WordPress site"}`
404	Post/Page not found	`{"status": "failed", "error": "Post/Page not found or unable to retrieve post information"}`
405	Method not allowed	`{"status": "failed", "error": "Method not allowed. Only POST requests are accepted."}`
429	Rate limit exceeded - Daily limit	`{"status": "failed", "error": "Daily limit exceeded. Try again tomorrow."}`
429	Rate limit exceeded - Per minute	`{"status": "failed", "error": "Rate limit exceeded. Try after 30 seconds."}`
500	Internal Server Error	`{"status": "failed", "error": "Failed to update post content"}`

Error Handling Best Practices

Always check the HTTP status code before processing the response

Implement retry logic for server errors (5xx) but not for client errors (4xx)

Respect rate limits and implement backoff mechanisms for 429 responses

Validate WordPress credentials before making API calls

Display meaningful error messages to your users

Contact & Support

If you need help with the API or want to request access credentials, we're here to help.

Getting Help

Email Support: [email protected]

Documentation: This Documentation

Request API Access

To get your API credentials (client_id and secret_key), please contact our team with the following information:

Your intended use case for the API
Expected monthly request volume
WordPress sites you plan to use it with
Your contact information

Request API Access

WordPress Setup Requirements

Before using this API, ensure your WordPress site has:

Prerequisites Checklist

JWT Authentication for WP REST API plugin installed and activated
WordPress user with Editor or Administrator privileges
REST API enabled (default in modern WordPress)
HTTPS enabled (recommended for security)