---
title: "List RetailMeNot blog posts"
method: GET
path: "/retailmenot/blog-posts"
tags: ["RetailMeNot"]
---

# List RetailMeNot blog posts

`GET /retailmenot/blog-posts`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/retailmenot/blog-posts`
- Auth: API key in header `x-api-key`

Returns one page of RetailMeNot blog posts (title, slug, URL, excerpt, description, author, published and modified dates, image, categories, and tags) with total and total pages, newest first by default. Filter by category slug, tag slug, and/or a search query; order by date, modified, title, or relevance (relevance requires query). A page past the end returns an empty list.

## Query parameters

- `query` string
- `category` string
- `tag` string
- `order_by` 'date' | 'modified' | 'title' | 'relevance'
- `order` 'desc' | 'asc'
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RetailmenotBlogPostsResponseDoc
  - `data` RetailmenotBlogPostsResponse
    - `category` string
    - `order` 'desc' | 'asc'
    - `order_by` 'date' | 'modified' | 'title' | 'relevance'
    - `page` integer
    - `page_size` integer
    - `posts` RetailmenotBlogPostSummary[]
      - `author` string
      - `categories` RetailmenotBlogTerm[]
        - `count` integer
        - `id` integer
        - `name` string
        - `slug` string
        - `url` string
      - `description` string
      - `excerpt` string
      - `id` integer
      - `image_url` string
      - `modified` string
      - `published` string
      - `slug` string
      - `tags` RetailmenotBlogTerm[]
        - `count` integer
        - `id` integer
        - `name` string
        - `slug` string
        - `url` string
      - `title` string
      - `url` string
    - `query` string
    - `tag` string
    - `total` integer
    - `total_pages` integer

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)