Flickr

Search Flickr groups

Search Flickr groups by name or description.

GET/v1/flickr/groups/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
querystringrequiredquery

Group name or description text.

min 1 chars · max 200 chars

cursorstringoptionalquery

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

pageintegeroptionalquery

Page number, 1-based. Default: 1. A page past the last returns an empty list with `hasMore: false`. Prefer `cursor` when continuing.

≥ 1 · ≤ 1000000

limitintegeroptionalquery

Rows per page, 1 to 100. Default: 100.

≥ 1 · ≤ 100

Response fields
36

Endpoint-specific response payload.

datalookupStatus
string

`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.

datagroups[]id
string

Group NSID.

datagroups[]alias
stringnullable

Path alias.

datagroups[]name
stringnullable

Group name as plain text.

datagroups[]description
stringnullable

Full description as HTML.

datagroups[]rules
stringnullable

Rules as HTML/text.

Group counts.

datagroups[]countsmembers
integernullable

Members.

datagroups[]countspoolPhotos
integernullable

Photos in the pool.

datagroups[]countstopics
integernullable

Discussion topics.

datagroups[]privacy
stringnullable

`public`, `private` or `invite_only`.

datagroups[]createdAt
stringnullable

Creation time, ISO 8601 UTC.

datagroups[]lastActivityAt
stringnullable

Last activity, ISO 8601 UTC.

datagroups[]isEighteenPlus
booleannullable

Whether the group is 18+.

datagroups[]invitationOnly
booleannullable

Whether joining needs an invitation.

datagroups[]iconUrl
stringnullable

Group icon URL.

Cover photo URLs.

datagroups[]coverPhotoh
stringnullable

Cover, 1600 pixels.

datagroups[]coverPhotol
stringnullable

Cover, 1024 pixels.

datagroups[]coverPhotos
stringnullable

Cover, 240 pixels.

datagroups[]coverPhotot
stringnullable

Cover, 100 pixels.

datagroups[]classification
stringnullable

Activity classification, e.g. `thriving`.

Pagination state for the current page.

datapagepage
integer

Current page number.

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number; null on the last page.

≥ 0

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetotalItems
integernullable

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.

datapagereachableItems
integernullable

Rows this endpoint can reach. Smaller than `totalItems` where this endpoint stops early. Null when `totalItems` is null.

datapagelimit
integer

Rows requested for this page.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

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.