EveryData platform API
Flickr API
This Flickr reference organizes Flickr media search results and media posted by a known NSID into 2 concrete operations—`search`, `user_posts` among them—so shared parameter names do not blur object types.
Read matching public results using Flickr `search` and posts from a known account using `user_posts`. `search` uses `keyword`, while `user_posts` uses `user_id`, with every subsequent action following the same scope separation.
- Endpoint
- POST /api/v1/social
- Capabilities
- 2
- Per 1,000
- $1.389
Available capabilities
Compare the Flickr actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Flickr. Accepts these parameters: | keyword | media_type, sort | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform |
user_postsPosts by user Retrieve public posts from Flickr. Accepts these parameters: | user_id | author_id, media_type, sort, username | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform |
What does each Flickr action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Flickr search parameters mean?
Search public results on Flickr. Accepts these parameters: keyword, media_type, and sort. Returns these fields: author_id, title, image_url, and media_type.
keywordRequired- 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_typeOptional- 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.Flickr: Media Type is Distinct from Content LicensingFlickr explicitly separates media type definitions from license classifications. EveryInfra currently provides the `media_type` parameter but does not expose official license parameters. Retrieving a photo or video through search does not grant usage rights to that asset.Checked
sortOptional- 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.Flickr: Sorting by Date Taken Versus Date PostedFlickr documentation differentiates sorting by date-taken from date-posted. While this clarifies time semantics, the default values, supported parameters, and maximum result limits of this endpoint strictly follow the EveryInfra contract rather than mirroring all official API capabilities.Checked
What do the Flickr user_posts parameters mean?
Retrieve public posts from Flickr. Accepts these parameters: sort, user_id, username, media_type, and author_id. Returns these fields: author_id, title, author_name, and tags.
user_idRequired- Specifies the target Flickr user's NSID, such as 12345678@N04, which can be retrieved from the author_id field of search results. It does not accept display names, vanity profile aliases, or full profile URLs.Flickr: Meaning of the User NSIDFlickr documentation defines `user_id` as the user NSID, which is distinct from a display screen name or custom profile URL path. This definition does not imply that EveryInfra can access a user's private photos.Checked
media_typeOptional- 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.
sortOptional- 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.
usernameOptional- Acts as a compatibility alias for user_id in user_posts. It still requires a valid Flickr NSID rather than a human-readable display name, and public user_posts requests must still include the required user_id parameter.
How to use the Flickr API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"flickr","action":"search","params":{"keyword":"<keyword>"}}'
Flickr API questions
What can I retrieve with the Flickr API?
Set platform to flickr. The current catalog lists search and posts by user. These action names identify different Flickr objects or views; they are not interchangeable search modes.
Which input starts a Flickr `search` request?
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. Send it as keyword inside params.
Which fields can Flickr `search` return?
Its declared schema includes title, image_url, media_type, and author_name. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Flickr action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.