Location Lens Image Generator

What is this Actor?

This Actor generates an image based on public posts for a given place. Provide a place name as input; the Actor looks at recent posts related to that place and creates one image that reflects the overall vibe. It saves the image to Key‑Value Store and simple metadata to Dataset. It does not scrape private data or require any login.

What can this Actor do?

• Generate a mood‑board style hero image that reflects a place’s aesthetic from public posts.
• Keep content safe by screening for sensitive inputs.

Why use this Actor on Apify?

• Monitoring & reliability: autoscaling, run logs, metrics, retries.
• API & integrations: trigger via REST API, webhooks, Make/Zapier, schedules.
• Storage: persistent Key‑Value Store for image, Dataset for metadata, plus shared files.
• Proxy options and platform‑managed workflows.

---

What data does it produce? (output fields)

You’ll get one dataset item per run and one image saved to the default Key‑Value Store.

Field	Type	Description
place	string	Input place name used for the search
captionsSample	string[]	Up to 5 sample captions used for context
imageKey	string	Key where the image is stored (default image.png)
generatedAt	string	ISO timestamp of generation

The image is stored under imageKey in the Key‑Value Store (default file name: image.png).

---

What to expect

• You provide a place name.
• The Actor generates a single 1024×1024 image that reflects the place’s vibe.
• You can download the image and a small metadata record after the run.

---

Quick start: Generate an image from Instagram posts

1. Open the Actor in Apify and go to the Run page.
2. Fill the input:
   • place: e.g., "Niagara Falls"
   • searchLimit: how many place results to retrieve (default 1)
   • resultsLimit: max number of posts to fetch (default 10)
3. Click Run. When it finishes, download the image from the Key‑Value Store (image.png).

Tip: To control cost and speed, lower resultsLimit. To capture more context, increase it.

---

Pricing and usage expectations

TODO

---

Input options

Defined in .actor/input_schema.json.

• place (string, required): Place to search posts for (e.g., "Niagara Falls").
• searchLimit (integer, default: 1): How many place search results to retrieve.
• resultsLimit (integer, default: 10): Max number of posts to fetch.

Example input:

{
  "place": "Niagara Falls",
  "searchLimit": 1,
  "resultsLimit": 100
}

---

Output examples

• Key‑Value Store: image.png (generated 1024×1024 PNG)
• Dataset item:

{
  "place": "Niagara Falls",
  "captionsSample": [
    "Waterfall views for days ",
    "Misty mornings at the falls",
    "Feeling tiny next to this power",
    "Rainbow over the gorge",
    "Tourist but make it cute"
  ],
  "imageKey": "image.png",
  "generatedAt": "2025-01-01T12:00:00.000Z"
}

You can download datasets from Apify in JSON, CSV, Excel, or via the Dataset API.

---

Other related Actors

Coming soon.

---

FAQ, disclaimers, and support

Is it legal to scrape posts?

Our scrapers are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our scrapers, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read our blog post on the legality of web scraping.

Support

Contact me via the Apify platform. Open to feedback and customizations.

---

Notes & limitations

• Content safety: Captions are moderated; flagged inputs abort image generation.
• Image size: default 1024x1024.