Headers
Get your API keyAPI key (`sfk_...`)
Group name or description text.
min 1 chars · max 200 chars
Cursor from `page.nextCursor` of the previous response. It only works with the same filters. Send it without `page`; it keeps the page size it was issued with, so `limit` may be sent again and has no effect.
min 1 chars · max 2048 chars
Page number, 1-based. Default: 1. A page past the last returns an empty list with `hasMore: false`. Prefer `cursor` when continuing.
≥ 1 · ≤ 1000000
Rows per page, 1 to 100. Default: 100.
≥ 1 · ≤ 100
Endpoint-specific response payload.
`found` when the entity exists; `not_found` when it does not exist or was deleted; `hidden` when the owner hides the data (EXIF); `private` when the group or pool is member-only; `restricted` when the group is age-restricted.
one of: found, not_found, hidden, private, restricted
Groups on this page.
Group NSID.
Path alias.
Group name as plain text.
Full description as HTML.
Rules as HTML/text.
Group counts.
Members.
Photos in the pool.
Discussion topics.
`public`, `private` or `invite_only`.
Creation time, ISO 8601 UTC.
Last activity, ISO 8601 UTC.
Whether the group is 18+.
Whether joining needs an invitation.
Group icon URL.
Cover photo URLs.
Cover, 1600 pixels.
Cover, 1024 pixels.
Cover, 240 pixels.
Cover, 100 pixels.
Activity classification, e.g. `thriving`.
Pagination state for the current page.
Current page number.
≥ 0
Whether another page is available.
Next page number; null on the last page.
≥ 0
Cursor for the next page; null on the last page.
Total rows in the whole list; null when no usable total is available, including a page past the end and a photo search with a taken time bound. It can change between calls.
Rows this endpoint can reach. Smaller than `totalItems` where this endpoint stops early. Null when `totalItems` is null.
Rows requested for this page.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/flickr/groups/search?query=sunset" \
-H "x-api-key: YOUR_API_KEY"Responses
Flickr group search.