Webhook Integration

Configure webhooks to receive article content from Rankfender directly to your website

Push Integration (Webhook)

Rankfender sends content directly to your website. Best for static sites or when you want full ownership of the content.

The endpoint where Rankfender will POST article data for English content

Additional HTTP headers as JSON. Use for authentication if needed.

Note: Set RANKFENDER_AUTH_TOKEN and RANKFENDER_API_KEY environment variables to enable authentication

Expected Payload Format

Article data structure that your webhook endpoint expects

{
  "title": "Article Title",
  "content": "<p>HTML content...</p>",
  "excerpt": "Short description",
  "meta_description": "SEO meta description",
  "meta_title": "SEO title",
  "keywords": ["keyword1", "keyword2"],
  "featured_image": "https://...",
  "author": "Author Name",
  "published_at": "2026-02-05T10:00:00Z",
  "slug": "article-slug",
  "seo_data": {
    "title_tag": "SEO Title",
    "meta_keywords": "keyword1, keyword2",
    "canonical_url": "https://..."
  },
  "custom_data": {
    "article_id": "uuid",
    "generated_by": "Rankfender",
    "language": "en",
    "word_count": 1500,
    "category": "SEO",
    "author_role": "SEO Expert",
    "author_bio": "Brief bio..."
  }
}

Integration Requirements

  • Your endpoint must accept POST requests with JSON payload
  • Return HTTP 200-299 status code for successful receipt
  • Optionally return {"url": "..."} with the published article URL
  • Articles are automatically stored in your Supabase database
  • Each language endpoint routes to the correct language blog

Configuration in Rankfender

1. Copy the webhook URL for your target language

Choose the appropriate endpoint based on the language of content you want to receive

2. Paste it into Rankfender's webhook configuration

Navigate to your Rankfender dashboard integration settings

3. Add authentication headers (optional)

If you've set up environment variables for authentication, add the corresponding headers

4. Test the connection

Use the test button above or Rankfender's test feature to verify the integration

5. Enable and publish

Once tested successfully, enable the webhook and start publishing articles