> **For coding agents and LLMs:** This is one page from the Social Fetch docs (markdown export). For curated orientation and workflow guidance, start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for agent onboarding and crawl rules, use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for the full endpoint list with links to pages like this one, use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt); for one platform's parameters and curls, use [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt); use [`/llms.json`](https://www.socialfetch.dev/llms.json) when you need structured JSON for tool registration. ## This page - **On-site (HTML):** - **Markdown (.mdx) URL:** ## API base URL and authentication - **API origin (from OpenAPI `servers`):** `https://api.socialfetch.dev` - **Authentication:** send `x-api-key: sfk_...` on `/v1/**` and `/v2/**` routes unless the operation is explicitly anonymous (check OpenAPI `security`, the [API reference hub](https://www.socialfetch.dev/docs/api.mdx), [`/llms.txt`](https://www.socialfetch.dev/llms.txt), or [`/llms.json`](https://www.socialfetch.dev/llms.json) for each route). - **OpenAPI JSON:** ## Recommended docs entrypoints (this site) - [Documentation overview](https://www.socialfetch.dev/docs.mdx) — top-level orientation (markdown). - [Quickstart](https://www.socialfetch.dev/docs/quickstart.mdx) — authenticate with `x-api-key`, validate auth with `whoami`, and understand the JSON envelope. - [SDK](https://www.socialfetch.dev/docs/sdk.mdx) — official TypeScript SDK guide, including `SocialFetchClient`, `Result`, and `unwrap()`. - [Capability matrix](https://www.socialfetch.dev/docs/capability-matrix.mdx) — every operation with identifiers, pagination, outcomes, media download, credits, and its SDK method. Generated from OpenAPI, so use it for route selection instead of scanning individual pages. - [Recipes](https://www.socialfetch.dev/docs/recipes.mdx) — copyable workflows (brand monitoring, transcripts, Ad Library, creator scoring, Reddit research) with credit callouts and SDK examples. - [Integrations](https://www.socialfetch.dev/docs/integrations.mdx) — MCP for AI clients, n8n verified node, Apify Store Actors, Make custom app, SDK, and REST API connection paths. - [MCP product page](https://www.socialfetch.dev/mcp) — hosted MCP overview, OAuth, Skills install. - [MCP integration](https://www.socialfetch.dev/docs/integrations/mcp.mdx) — hosted `/mcp` server, OAuth, Cursor/VS Code/Claude install snippets, 910 endpoint tools, plus docs_search/docs_read for implementation help. - [n8n integration](https://www.socialfetch.dev/docs/integrations/n8n.mdx) — install `n8n-nodes-socialfetch`, credentials, and workflow examples. - [Apify integration](https://www.socialfetch.dev/docs/integrations/apify.mdx) — Store Actors under @social-fetch, PPE billing, dataset export, and quick start. - [Make integration](https://www.socialfetch.dev/docs/integrations/make.mdx) — custom app modules for Make scenarios, API key credentials, and module catalog. - [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt) — every documented operation with a direct link to that route's agent-readable markdown page (prefer this over parsing OpenAPI). - [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt) — per-platform endpoint files generated from OpenAPI (parameters, credits, curls). - [`/agents.txt`](https://www.socialfetch.dev/agents.txt) — agent crawl/onboarding file with capabilities, auth rules, and allowlist. - [`/llms.json`](https://www.socialfetch.dev/llms.json) — structured machine-readable operation inventory with parameter names, pagination, outcomes, credits, and SDK mapping. - [API reference hub](https://www.socialfetch.dev/docs/api.mdx) — human-friendly index of operations with links into generated pages. - [Errors](https://www.socialfetch.dev/docs/errors.mdx) — shared error envelope and HTTP status guidance. - [Credits](https://www.socialfetch.dev/docs/credits.mdx) — metering, `402`, and planning batch jobs. - Outcome semantics such as `found`, `not_found`, and `private` are documented in [Errors](https://www.socialfetch.dev/docs/errors.mdx) and on operation pages when present in the OpenAPI contract. ## Markdown docs convention - Every docs page has a markdown twin: append **`.mdx`** to the docs pathname (for example `/docs/quickstart` → `/docs/quickstart.mdx`). - Agents that send `Accept: text/markdown` on `/docs/**` HTML URLs may receive markdown directly (same URL, `Vary: Accept`). - Published blog posts use the same convention: `/blog/{slug}` → `/blog/{slug}.mdx`, or `Accept: text/markdown` on the HTML URL (`Vary: Accept`). --- # Get Flickr user (https://www.socialfetch.dev/docs/api/v1/flickr/users/userid/get) ## Summary Get a Flickr public profile with identity, counts, links, testimonials and popular photos. **Tags:** `Flickr` ## HTTP - **Method:** GET - **Path:** `/v1/flickr/users/{userId}` - **Base URL:** `https://api.socialfetch.dev` ## Capability summary - **SDK mapping:** `client.flickr.getUser({ userId: "bees" })` - **Accepted identifiers:** `userId` (path) - **Pagination:** none - **Business outcome field:** `data.lookupStatus` with values `found`, `not_found`, `hidden`, `private`, `restricted` ## Credits - **Base:** 1 credit per successful lookup. - **Maximum on success (200):** 1 credit. - **Failed requests (`lookup_failed`, `503`):** not charged. - **Authoritative field:** `meta.creditsCharged`. ## Authentication - **`x-api-key`**: API key (`sfk_...`) ## Parameters ### `userId` (path) - **Required:** yes - **Constraints:** type `string`; minLength: 1; maxLength: 80; pattern: `^(?:[0-9]{1,20}@N[0-9]{2}|[A-Za-z0-9][A-Za-z0-9._-]{0,79})$` - **Description:** NSID (`12037949754@N01`) or path alias (`bees`). ## Behavior notes - **`userId`**: NSID (`12037949754@N01`) or path alias (`bees`). ## Responses (status codes) - **200**: Flickr user. - **400**: Invalid request - **401**: Missing or invalid API key - **402**: Insufficient credits - **413**: The document is larger than the maximum size we can return; no charge. - **500**: Unexpected or billing error - **502**: Lookup could not be completed. - **503**: Service temporarily unavailable; safe to retry with backoff. ## Response body (200) Flickr user. ### Field outline - **data** (required) — type `object`. Endpoint-specific response payload. - **lookupStatus** (required) — type `string`; enum: found, not_found, hidden, private, restricted. `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. - **user** (required) — type `object`; nullable. A public Flickr profile. - **id** (required) — type `string`; nullable. NSID. - **alias** (required) — type `string`; nullable. Path alias used in URLs. - **name** (required) — type `string`; nullable. Display name, with bidi controls removed. - **realName** (required) — type `string`; nullable. Real name the person chose to show. - **location** (required) — type `string`; nullable. Location the person chose to show. - **isPro** (required) — type `boolean`; nullable. Whether the account is Pro. - **proTier** (required) — type `string`; nullable. Pro badge, `standard` or `legacy`. - **createdAt** (required) — type `string`; nullable. Account creation time, ISO 8601 UTC. - **avatar** (required) — type `object`. The person's avatar at three sizes. - **small** (required) — type `string`; nullable. Square avatar URL, 100 pixels. - **medium** (required) — type `string`; nullable. Avatar URL, 240 pixels. - **large** (required) — type `string`; nullable. Avatar URL, 500 pixels. - **profileUrl** (required) — type `string`; nullable. Profile page URL. - **photosUrl** (required) — type `string`; nullable. Photostream URL. - **description** (required) — type `string`; nullable. Profile text as HTML. - **descriptionText** (required) — type `string`; nullable. Profile text as plain text, with markup removed and entities decoded. - **email** (required) — type `string`; nullable. Email address the person typed into their public profile contact field; null when not shown. - **hometown** (required) — type `string`; nullable. Hometown. - **city** (required) — type `string`; nullable. City. - **country** (required) — type `string`; nullable. Country. - **occupation** (required) — type `string`; nullable. Occupation. - **website** (required) — type `string`; nullable. Website the person lists. - **firstName** (required) — type `string`; nullable. First name. - **lastName** (required) — type `string`; nullable. Last name. - **social** (required) — type `object`. Handles typed into the public profile and the URLs for them. - **facebook** (required) — type `string`; nullable. Facebook handle the person lists. - **facebookUrl** (required) — type `string`; nullable. Facebook profile URL. - **instagram** (required) — type `string`; nullable. Instagram handle the person lists. - **instagramUrl** (required) — type `string`; nullable. Instagram profile URL. - **twitter** (required) — type `string`; nullable. Twitter handle the person lists. - **twitterUrl** (required) — type `string`; nullable. Twitter profile URL. - **tumblr** (required) — type `string`; nullable. Tumblr handle the person lists. - **tumblrUrl** (required) — type `string`; nullable. Tumblr profile URL. - **pinterest** (required) — type `string`; nullable. Pinterest handle the person lists. - **pinterestUrl** (required) — type `string`; nullable. Pinterest profile URL. - **testimonials** (required) — type `array`. Public testimonials on the profile. - _items:_ - **popularPhotos** (required) — type `array`. The profile's most popular photos. - _items:_ - **showcaseAlbumId** (required) — type `string`; nullable. Album shown in the profile's showcase slot. - **coverPhoto** (required) — type `object`; nullable. Cover photo URLs; null when the account has none. - **h** (required) — type `string`; nullable. Cover, 1600 pixels. - **l** (required) — type `string`; nullable. Cover, 1024 pixels. - **s** (required) — type `string`; nullable. Cover, 240 pixels. - **t** (required) — type `string`; nullable. Cover, 100 pixels. - **counts** (required) — type `object`. Counts on the public profile. - **photos** (required) — type `integer`; nullable. Photos. - **followers** (required) — type `integer`; nullable. Followers. - **following** (required) — type `integer`; nullable. Accounts followed. - **views** (required) — type `integer`; nullable. Lifetime photo views. - **tags** (required) — type `integer`; nullable. Tagged photos, as the public profile reports them; this can differ slightly from the user's tag list. - **geotagged** (required) — type `integer`; nullable. Geotagged photos. - **favorites** (required) — type `integer`; nullable. Photos favourited. - **photosInGroups** (required) — type `integer`; nullable. Photos added to groups. - **profileAvailable** (required) — type `boolean`. False when the account was found but the public profile record was not available; profile fields are then null. - **countsAvailable** (optional) — type `boolean`; default: `false`. False when the follower, following, view and other totals are unavailable; those counts and the related fields are then null or empty. - **meta** (required) — type `object`. Metadata describing the request and billing outcome. - **requestId** (required) — type `string`; minLength: 1. Unique request identifier for tracing this API call. - **creditsCharged** (required) — type `integer`; minimum: 0. Credits charged for this request. - **version** (required) — type `string`; enum: v1. Public API version that served the response. ### Example JSON (found) ```json { "data": { "lookupStatus": "found", "user": { "id": "12037949754@N01", "alias": "bees", "name": "bees", "realName": "Cal Henderson", "location": "San Francisco, USA", "isPro": true, "proTier": "legacy", "createdAt": "2003-05-21T22:05:45.000Z", "avatar": { "small": "https://farm1.staticflickr.com/122/buddyicons/12037949754@N01_s.jpg?1200501238", "medium": "https://farm1.staticflickr.com/122/buddyicons/12037949754@N01_m.jpg?1200501238", "large": "https://farm1.staticflickr.com/122/buddyicons/12037949754@N01_l.jpg?1200501238" }, "profileUrl": "https://www.flickr.com/people/bees/", "photosUrl": "https://www.flickr.com/photos/bees/", "description": "