# Get photo

Fetches details about a public Facebook photo including image URL and engagement metadata.

- Platform: [Facebook](https://docs.upscrape.com/docs/platforms/facebook)
- Capability ID: `facebook.photo.get`
- Cost: 1 credit per request
- Maximum runtime: 30 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "url": "https://www.facebook.com/NASA/photos/1496429658519072"
  },
  "capability": "facebook.photo.get"
}'
```

## Input


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | `string` | Yes | Public, page-anchored Facebook photo URL Default: `https://www.facebook.com/NASA/photos/1496429658519072`. |

### Example input

```json
{
  "url": "https://www.facebook.com/NASA/photos/1496429658519072"
}
```

## Response

Successful output is returned in `results[0].data`.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This example shows one response. Values and optional fields vary with the data available.

```json
{
  "__isMedia": "Photo",
  "__isNode": "Photo",
  "__typename": "Photo",
  "accessibility_caption": "No photo description available.",
  "attached_comment": null,
  "can_viewer_add_tags": false,
  "can_viewer_edit": false,
  "cix_screen": null,
  "comet_photo_renderer": null,
  "container_story": null,
  "copyright_banner_info": null,
  "created_time": 1775567235,
  "creation_story": {
    "__module_component_useCometUFIAdaptivePostActionBar_story": {
      "__dr": "CometUFIAdaptiveShareActionRenderer.react"
    },
    "__module_operation_useCometUFIAdaptivePostActionBar_story": {
      "__dr": "CometUFIAdaptiveShareActionRenderer_story$normalization.graphql"
    },
    "actors": [
      {
        "__typename": "User",
        "id": "100044561550831",
        "name": "NASA - National Aeronautics and Space Administration"
      }
    ],
    "attachments": [
      {
        "action_links": []
      }
    ],
    "business_content_type": "SINGLE_IMAGE",
    "can_viewer_boost": false,
    "can_viewer_edit": false,
    "click_tracking_linkshim_cb": "[redacted:token]",
    "delegate_page_id": "54971236771",
    "encrypted_click_tracking": "[redacted:token]",
    "encrypted_tracking": "[redacted:token]",
    "id": "[redacted:token]",
    "inform_treatment_for_messaging": null,
    "legacy_story_hideable_id": "1496429658519072",
    "message": null,
    "post_audience_building_info": null,
    "post_id": "1496429658519072",
    "post_promotion_info": null,
    "save_info": {
      "savable": {
        "__typename": "Photo",
        "id": "1496429658519072",
        "savable_title": {
          "text": "NASA - National Aeronautics and Space Administration's Photo"
        }
      },
      "save_flow": null,
      "viewer_save_state": "NOT_SAVED"
    },
    "seo_title": null,
    "shareable": null,
    "shareable_from_perspective_of_feed_ufi": null,
    "sponsored_data": null,
    "target_group": null,
    "tracking": "{\"top_level_post_id\":\"1496429658519072\",\"content_owner_id_new\":\"100044561550831\",\"page_id\":\"54971236771\",\"photo_id\":\"1496429658519072\",\"story_location\":9,\"story_attachment_style\":\"cover_photo\",\"ent_attachement_type\":\"CoverPhotoAttachment\",\"page_insights\":{\"100044561550831\":{\"page_id\":\"100044561550831\",\"page_id_type\":\"page\",\"actor_id\":\"100044561550831\",\"dm\":{\"isShare\":0,\"originalPostOwnerID\":0,\"sha…",
    "url": "https://www.facebook.com/photo/?fbid=1496429658519072&set=a.416660999829282",
    "vote_attachments": [],
    "whatsapp_ad_context": null
  },
  "default_mediaset": {
    "__isMediaSet": "Album",
    "__typename": "Album",
    "id": "416660999829282",
    "nextMedia": {
      "edges": [
        {
          "node": {
            "__isMedia": "Photo",
            "__isNode": "Photo",
            "__typename": "Photo",
            "id": "1491468662348505",
            "is_playable": false,
            "owner": {
              "__typename": "User",
              "id": "100044561550831"
            }
          }
        }
      ]
    },
    "prevMedia": {
      "edges": []
    }
  },
  "feedback": {
    "__typename": "Feedback",
    "associated_video": null,
    "can_viewer_react": false,
    "id": "ZmVlZGJhY2s6MTQ5NjQyOTY1ODUxOTA3Mg==",
    "if_viewer_can_comment_anonymously": null,
    "if_viewer_has_locked_actor": null,
    "if_viewer_post_type_blocks_alternate_voice": null,
    "reactors": {
      "count": 169541,
      "is_empty": false
    },
    "supported_reaction_infos": [
      {
        "id": "1635855486666999"
      },
      {
        "id": "1678524932434102"
      },
      {
        "id": "115940658764963"
      }
    ],
    "top_reactions": {
      "edges": [
        {
          "node": {
            "id": "1635855486666999"
          },
          "reaction_count": 81844
        },
        {
          "node": {
            "id": "1678524932434102"
          },
          "reaction_count": 75288
        },
        {
          "node": {
            "id": "478547315650144"
          },
          "reaction_count": 8214
        }
      ]
    },
    "unified_reactors": {
      "count": 169541
    },
    "url": "https://www.facebook.com/photo.php?fbid=1496429658519072&set=a.416660999829282&type=3",
    "viewer_actor": null,
    "viewer_feedback_reaction_info": null
  },
  "id": "1496429658519072",
  "if_media_can_show_link_to_container_story": null,
  "image": {
    "height": 1366,
    "uri": "https://lookaside.fbsbx.com/lookaside/crawler/media/?media_id=1496429658519072",
    "width": 2048
  },
  "is_playable": false,
  "owner": {
    "__typename": "User",
    "additional_profile_has_taggable_products": false,
    "id": "100044561550831",
    "is_member_of_readonly_work_company": false,
    "user_id": "100044561550831"
  },
  "photo_product_tags": [],
  "tags": {
    "edges": []
  }
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `__isMedia` | `string` | Photo |
| `__isNode` | `string` | Photo |
| `__typename` | `string` | Photo |
| `accessibility_caption` | `string` | No photo description available. |
| `attached_comment` | `null` | null |
| `can_viewer_add_tags` | `boolean` | false |
| `can_viewer_edit` | `boolean` | false |
| `cix_screen` | `null` | null |
| `comet_photo_renderer` | `null` | null |
| `container_story` | `null` | null |
| `copyright_banner_info` | `null` | null |
| `created_time` | `integer` | 1775567235 |
| `creation_story` | `object` | 28 fields |
| `creation_story.__module_component_useCometUFIAdaptivePostActionBar_story` | `object` | 1 fields |
| `creation_story.__module_operation_useCometUFIAdaptivePostActionBar_story` | `object` | 1 fields |
| `creation_story.actors` | `array` | 1 items |
| `creation_story.attachments` | `array` | 1 items |
| `creation_story.business_content_type` | `string` | SINGLE_IMAGE |
| `creation_story.can_viewer_boost` | `boolean` | false |
| `creation_story.can_viewer_edit` | `boolean` | false |
| `creation_story.click_tracking_linkshim_cb` | `string` | [redacted:token] |
| `creation_story.delegate_page_id` | `string` | 54971236771 |
| `creation_story.encrypted_click_tracking` | `string` | [redacted:token] |
| `creation_story.encrypted_tracking` | `string` | [redacted:token] |
| `creation_story.id` | `string` | [redacted:token] |
| `creation_story.inform_treatment_for_messaging` | `null` | null |
| `creation_story.legacy_story_hideable_id` | `string` | 1496429658519072 |
| `creation_story.message` | `null` | null |
| `creation_story.post_audience_building_info` | `null` | null |
| `creation_story.post_id` | `string` | 1496429658519072 |
| `creation_story.post_promotion_info` | `null` | null |
| `creation_story.save_info` | `object` | 3 fields |
| `creation_story.seo_title` | `null` | null |
| `creation_story.shareable` | `null` | null |
| `creation_story.shareable_from_perspective_of_feed_ufi` | `null` | null |
| `creation_story.sponsored_data` | `null` | null |
| `creation_story.target_group` | `null` | null |
| `creation_story.tracking` | `string` | {"top_level_post_id":"1496429658519072","content_owner_id_new":"1000445… |
| `creation_story.url` | `string` | https://www.facebook.com/photo/?fbid=1496429658519072&set=a.41666099982… |
| `creation_story.vote_attachments` | `array` | 0 items |
| `creation_story.whatsapp_ad_context` | `null` | null |
| `default_mediaset` | `object` | 5 fields |
| `default_mediaset.__isMediaSet` | `string` | Album |
| `default_mediaset.__typename` | `string` | Album |
| `default_mediaset.id` | `string` | 416660999829282 |
| `default_mediaset.nextMedia` | `object` | 1 fields |
| `default_mediaset.prevMedia` | `object` | 1 fields |
| `feedback` | `object` | 14 fields |
| `feedback.__typename` | `string` | Feedback |
| `feedback.associated_video` | `null` | null |
| `feedback.can_viewer_react` | `boolean` | false |
| `feedback.id` | `string` | ZmVlZGJhY2s6MTQ5NjQyOTY1ODUxOTA3Mg== |
| `feedback.if_viewer_can_comment_anonymously` | `null` | null |
| `feedback.if_viewer_has_locked_actor` | `null` | null |
| `feedback.if_viewer_post_type_blocks_alternate_voice` | `null` | null |
| `feedback.reactors` | `object` | 2 fields |
| `feedback.supported_reaction_infos` | `array` | 3 items |
| `feedback.top_reactions` | `object` | 1 fields |
| `feedback.unified_reactors` | `object` | 1 fields |
| `feedback.url` | `string` | https://www.facebook.com/photo.php?fbid=1496429658519072&set=a.41666099… |
| `feedback.viewer_actor` | `null` | null |
| `feedback.viewer_feedback_reaction_info` | `null` | null |
| `id` | `string` | 1496429658519072 |
| `if_media_can_show_link_to_container_story` | `null` | null |
| `image` | `object` | 3 fields |
| `image.height` | `integer` | 1366 |
| `image.uri` | `string` | https://lookaside.fbsbx.com/lookaside/crawler/media/?media_id=149642965… |
| `image.width` | `integer` | 2048 |
| `is_playable` | `boolean` | false |
| `owner` | `object` | 5 fields |
| `owner.__typename` | `string` | User |
| `owner.additional_profile_has_taggable_products` | `boolean` | false |
| `owner.id` | `string` | 100044561550831 |
| `owner.is_member_of_readonly_work_company` | `boolean` | false |
| `owner.user_id` | `string` | 100044561550831 |
| `photo_product_tags` | `array` | 0 items |
| `tags` | `object` | 1 fields |
| `tags.edges` | `array` | 0 items |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)