# Flickr Group API Documentation

Retrieve a public Flickr group (name, description in HTML and plain text, member count, pool count, privacy label and throttle) plus one page of the group pool with views and photopage URLs. Pool photos can be filtered by tag. A valid group with an empty pool is a successful response.

- **Documentation:** [https://scrappa.co/docs/flickr-api/flickr_group](https://scrappa.co/docs/flickr-api/flickr_group)
- **API group:** Flickr API
- **Endpoint:** `GET https://scrappa.co/api/flickr/group`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `group_id` | string | Yes | Flickr group NSID. Example: 89628549@N00. |
| `page` | integer | No | 1-based pool page. Defaults to 1. |
| `per_page` | integer | No | Pool photos per page (1-500). Defaults to 10. |
| `tags` | string | No | Filter the pool by one tag. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/flickr/group?group_id=89628549%40N00&per_page=3"
```

## Example response

```json
{
    "success": true,
    "data": {
        "info": {
            "id": "89628549@N00",
            "nsid": "89628549@N00",
            "name": "Golden Gate Views",
            "description": "The Golden Gate Bridge may be the most photographed public site on earth...",
            "description_plain": "The Golden Gate Bridge may be the most photographed public site on earth...",
            "members_count": 1945,
            "pool_count": 11048,
            "privacy": "Public",
            "throttle": {
                "mode": "none"
            }
        },
        "pool": {
            "page": 1,
            "pages": 3684,
            "per_page": 3,
            "total": 11051,
            "has_more": true,
            "results": [
                {
                    "id": "55586094851",
                    "owner": "30235075@N05",
                    "owner_name": "kate beale",
                    "title": "Backlit Golden Gate Bridge in B&W",
                    "views": 84,
                    "date_added": "2026-10-13T02:43:45Z",
                    "url": "https://www.flickr.com/photos/30235075@N05/55586094851",
                    "image_url": "https://live.staticflickr.com/65535/55586094851_3c094b8657.jpg"
                }
            ]
        }
    },
    "meta": {
        "endpoint_family": "group_info",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Group Not Found | The requested Flickr Group was not found. This response is not billable. |
| 422 | Validation Error | A public parameter or range is invalid. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)