listSingleImagePosts
Retrieve a paginated list of single-image posts such as blog articles, events, jobs, coupons, videos, and discussions, with optional filters by user or post type.
Instructions
List posts - Paginated enumeration of post records. Read-only.
Lean-by-default keep-list: rows return only the core identity + routing + load-bearing fields: post_id, post_title, post_filename, post_status, post_start_date, post_expire_date, post_location, post_venue, post_category, data_id, data_type, system_name, data_name, data_filename, user_id, post_image, original_image_url, revision_timestamp, plus total_clicks (only when > 0) / total_photos rollups. Everything else stripped — restore via flags:
include_content=1- returnpost_content(HTML body).include_post_seo=1- returnpost_meta_title,post_meta_description,post_meta_keywords.include_author_full=1- return the fullusernested object. Default omits author detail entirely; callgetUser(user_id)for author records.include_clicks=1- return the full click array underuser_clicks_schema.include_photos=1- return the fullusers_portfoliophoto array (multi-image posts).include_extras=1- return everything else (lat,lon,country_sn,state_sn,post_org_url,post_date,post_live_date,post_updated,post_token,post_clicks,recurring_type,sticky_post,post_featured,post_tags,post_job,post_video,post_price,image_imported, etc.).
Use when: enumerating posts of single-image families - blog articles, events, jobs, coupons, videos, discussions. Filter by user_id for one member's posts, or data_id to scope to one post type. Before using, confirm the target post type has data_type 9 or 20 (single-image); data_type=4 means multi-image and you want listMultiImagePosts instead.
Pagination: cursor-based (limit, page). See Rule: Pagination for full cursor/cap/stop semantics.
Filter/sort: property+property_value+property_operator, order_column+order_type. See Rule: Filter operators for the verified-working operator set, silent-drop detection, and derived-field unfilterability.
See also: getSingleImagePost (single record by ID). For keyword-in-body matching, use this tool with property=post_title property_operator=LIKE (or post_caption/post_content).
Returns: { status: "success", total, current_page, total_pages, next_page, prev_page, message: [...records] }. Each record is the lean-shaped resource object.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Pagination cursor (use next_page from previous response) | |
| limit | No | Records per page (default 25, max 100) | |
| property | No | Column key to filter by (present on the response rows; a wrong name silently returns empty). For multi-condition AND, pass parallel arrays here and in `property_value`/`property_operator` — equal length, Nth entries paired. See Rule: Compound filters. | |
| order_type | No | Sort direction: ASC or DESC | |
| fields_only | No | Exact-list response trim: CSV of post field names; each returned row carries exactly these fields. Authoritative when present - include_* flags are moot. An unknown name errors (teaching message) so a typo never silently drops a field. Name the identity columns PLUS every column your match criteria judge: title-only checks use post_id,post_title,post_status,post_filename; checks that judge dates, venues, companies, or locations add post_start_date,post_venue,post_location. ~70% smaller responses, immune to output truncation, total/next_page always intact. | |
| order_column | No | Column to sort by — a column key present on the response rows (a wrong name silently returns empty) | |
| include_clicks | No | Opt in to return `user_clicks_schema.clicks` array. Default: `total_clicks` count surfaced only when > 0; absent means zero clicks. | |
| include_extras | No | Opt in to return ALL remaining fields on this resource that are not in the lean-by-default keep-list and not gated by another `include_*` flag. Lean default returns only the core identity, routing, and load-bearing fields. `include_extras=1` restores everything else (geo, all hero_*, layout/sidebar/menu config, all display toggles, admin metadata, etc.). Resource-specific — see each tool's description for what the extras bundle contains. | |
| include_photos | No | Opt in to return `photos_schema` array. Default: `total_photos` count only (`image_main_file` URL always returned). | |
| property_value | No | Value to filter by; array to pair with a `property` array (same length). | |
| include_content | No | Opt in to return the full `post_content` HTML body. Default stripped (`post_title` + `post_caption` always returned). | |
| include_post_seo | No | Opt in to return `post_meta_title`, `post_meta_description`, `post_meta_keywords`. Default stripped. | |
| property_operator | No | Filter operator (word-form; symbol forms WAF-stripped). Single: eq, ne, lt, lte, gt, gte, like, not_like. CSV: in, not_in, between. Substring: contains, starts_with, ends_with (+not_). Date: year_eq, month_eq, day_eq (+not_), since_days, until_days. Length: length_eq, length_lt, length_gt, length_between. Null: is_set, is_not_set, is_null, is_not_null. Array to pair with a `property` array (same length). See Rule: Filter operators for value shapes. | |
| include_author_full | No | Opt in to return the full original `user` nested object (every field BD returns, including `password` hash, session `token`, `cookie`). Default: author detail omitted entirely — call `getUser(user_id)` when needed. |