# Flickr Search API (flickr.search)

- Canonical page: [https://everyinfra.com/en/flickr-api/search](https://everyinfra.com/en/flickr-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "flickr", "action": "search", "params": {...}}
- Price: $0.024 per call ($24 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 10, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

Flickr Search finds public photos, and videos when you ask for them, by `keyword` and returns each item's title, image and page links, media type, tags, the photographer's name and ID, when the photo was taken and when it was uploaded. Designers, editors and researchers use it to find images of a subject, study how a place or event has been photographed, or gather candidates for a visual dataset.

`keyword` is not an exact lookup of a photographer's name. `sort` defaults to relevance and also orders by interestingness, upload date or capture date, in either direction. `taken_at` comes from the photo's EXIF data and can differ from `posted_at`, the upload time; it can also be null. A photo without tags returns `tags` as an empty array.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=flickr&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies the search term for photos or videos in the search action. The returned media scope is controlled by media_type, and this parameter does not perform exact author display name lookups. |
| media_type | not declared | no | not declared | Filters media scope with allowed values: photos (photos only), videos (videos only), or all (all media). Defaults to photos in search and all in user_posts. This parameter controls query filtering and does not determine whether raw source files are downloaded. |
| sort | not declared | no | not declared | Sorts photos and videos in search (defaults to relevance) and user_posts (defaults to date-posted-desc). Supported values include relevance, interestingness-desc, interestingness-asc, date-posted-desc, date-posted-asc, date-taken-desc, and date-taken-asc. Upload dates (date-posted) and capture dates (date-taken) represent distinct attributes and cannot be used interchangeably. |
| limit | integer (1–50) | no | 10 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| media_type | platform-native meaning |
| author_name | Author's display name. |
| author_id | Author's unique ID on the platform. |
| tags | Array of tags. An empty array, not null, when there are none. |
| taken_at | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "flickr",
  "action": "search",
  "params": {
    "keyword": "street photography"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "flickr",
        "action": "search",
        "params": {
            "keyword": "street photography",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "flickr",
  "action": "search",
  "results": [
    {
      "id": "•••",
      "url": "https://www.flickr.com/photos/199101808@N07/55551766234/",
      "title": "A great place to enjoy a Schwarzwälder Kirschtorte, Freiburg, Germany, 2026",
      "image_url": "https://live.staticflickr.com/65535/55551766234_9457abf045_b.jpg",
      "media_type": "image",
      "author_name": "•••",
      "author_id": "•••",
      "tags": [
        "schwarzwälderkirschtorte",
        "café",
        "blackandwhite"
      ],
      "taken_at": "2026-08-25T18:09:53-08:00",
      "posted_at": "2026-09-26T09:33:25+00:00",
      "platform": "flickr"
    },
    {
      "id": "•••",
      "url": "https://www.flickr.com/photos/189004250@N02/55551755389/",
      "title": "like a microphone",
      "image_url": "https://live.staticflickr.com/65535/55551755389_ba32644d34_b.jpg",
      "media_type": "image",
      "author_name": "•••",
      "author_id": "•••",
      "tags": [
        "nikon",
        "z8",
        "monochrome"
      ],
      "taken_at": "2026-08-05T16:23:35-08:00",
      "posted_at": "2026-09-26T09:33:55+00:00",
      "platform": "flickr"
    }
  ],
  "count": 10,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### What is the difference between `taken_at` and `posted_at`?

`taken_at` is when the photo was shot, read from its EXIF data, and it can be null. `posted_at` is when it was uploaded to Flickr. To order by capture time use date-taken-desc or date-taken-asc in `sort`, and by upload time date-posted-desc or date-posted-asc; the two kinds of date do not mix.

### How do I see more work from a photographer I found?

Take `author_id` from the result, an NSID shaped like 12345678@N04, and pass it as the user ID to the Flickr Posts by user capability. That capability needs the NSID; display names and profile short names do not work there.

### How do I search videos as well as photos?

Set `media_type` to videos for videos only, or to all for both; search looks at photos unless you say otherwise. `media_type` on each row tells you which kind it is. The setting chooses what to search, not whether original files are downloaded.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=flickr
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
