Import videos from a JSON feed

Learn how to import videos from a JSON feed URL in Brand Control Center, review the AI-mapped fields, and run the import once or on a recurring schedule.

Direct Import pulls videos from your own API's JSON endpoint, so you don't upload them one by one and no engineering work is needed. Octo, Genuin's Supervised Intelligence interface, maps your API's fields to Genuin's system fields, even when they use non-standard names.

You can import once, or set a scheduler that imports hourly, daily, weekly, or monthly. Each scheduler saves imported videos as drafts for review, publishes them immediately, or posts them on a separate schedule. Genuin deduplicates videos, filters them by duration, and parses the feed data on its backend.

Feed imports are part of content curation in Brand Control Center (BCC), under the rules that Control sets for every post. For the product as a whole, see Control: what it does and where to start. For the AI that maps your fields, see Supervised Intelligence: what it does and where to start.

Add the JSON feed URL

1. In Brand Control Center, go to Curate > Activity > + New Post.

1. Select Direct Import.

1. From the dropdown, choose JSON. The dropdown offers RSS/MRSS, XML, and JSON, and you must select one of them.

1. Paste your JSON endpoint URL. Genuin starts validating the URL immediately.

While a URL is in the field, the upload section is disabled. Remove the URL to re-enable it.

Validation runs three checks in order: format, duplicate scheduler, and accessibility. The URL must pass all three before Genuin maps its fields.

Review the AI-mapped fields

After the URL passes validation, Octo maps the feed's fields to Genuin's system fields. An animation plays with the message "AI is mapping the required fields…", and mapping takes about 10–15 seconds.

Genuin maps these fields automatically: video_id, video_url, title, description, duration, thumbnail, and published_at. Each AI-mapped field is highlighted for about 2 seconds and shows a match rate (%) label.

To override a mapping, choose a different field from its dropdown. Verify every AI-mapped field before you import because required fields must be mapped.

Check the field reference (Optional)

We recommend checking the field reference before you import because it shows which fields your feed must provide. Click the here link in the notice that the system expects a specific JSON format to open the Field Reference window.

Add authorization and query parameters (Optional)

• Authorization: select the toggle, then choose Basic Auth and enter a username and password, or choose Bearer Token and enter the token. When the toggle is on, its fields are required.
• Query Parameter: select the toggle, then add a Key, a Value, and a Max Value. Use pagination for large feeds.

Choose the destination and import

1. Under Import in, choose a community and a group. The Import button stays disabled until you select both.

1. Click Import to open the import options.
2. Choose how to run the import:
   • Direct Import runs a one-time import and doesn't create a scheduler. Genuin shows "Your videos are being imported from your JSON".
   • Import & Schedule runs the import immediately and creates a scheduler. Genuin shows "Your scheduler was successfully set and videos are being imported".

Review and publish imported videos

Imported videos appear in Curate > Activity, which sorts posts into four statuses: Awaiting to post, Processing, Approved, and Rejected. Each imported video appears in the Processing tab first, then moves to Awaiting to post.

1. Go to Curate > Activity.

1. Click a video to open the Post Details view.
2. Click Approve & Post to publish the video, or Reject to decline it.
3. Click Next to move to the next post. Next moves across posts, even across import tasks.

If a scheduled import fails, Activity shows an error message and a retry option. Learn more about review in Moderation Baselines and Queue.

Create a scheduler from the Scheduler panel

Besides Import & Schedule, you can create a scheduler directly from the Scheduler panel. This flow sets the import frequency and the posting option together.

1. On the Direct Import page, click Schedule to open the Scheduler panel. Under Manage Schedulers, click + Add URL, then choose Add JSON.

1. Add the JSON URL.

1. Wait for validation and AI mapping, which take about 10–15 seconds.

1. Configure the field mapping, authorization, and query parameters.

1. Choose the Import frequency: Hourly, Daily, Weekly, or Monthly.

1. Choose a posting option:
   • Save as drafts (manual posting): imported videos wait for manual review.
   • Auto publish immediately: imported videos are published automatically after import.
   • Schedule publishing: videos post on their own schedule, separate from the import schedule.

Import and posting schedules

The import frequency decides when Genuin fetches the feed and which posting frequencies you can pair with it.

The posting time must be at least 4 hours after the import time. Genuin posts only after the import runs, and it keeps the time gap you set. For example, you can pair a daily import with weekly posting, a weekly import with monthly posting, or a monthly import with monthly posting.

Keep your import and posting schedules aligned, and review your draft workflows to keep quality high.

Example setups

Edit a scheduler

1. On the Direct Import page, click Schedule, then click the pencil icon on the scheduler you want to change.

1. (Optional) Change the JSON URL. Genuin re-validates the URL and re-runs AI mapping on its fields.

1. (Optional) Change the authorization or the query parameters.

1. (Optional) Change the posting configuration.

1. In the confirmation prompt, click Apply changes to save your edits, or Cancel to discard them. Genuin shows "Scheduler updated successfully."

Delete a scheduler

1. Click the trash icon on the scheduler.

1. Click Delete Scheduler to confirm.

Add more schedulers

Click + Add Scheduler to add another scheduler. The new scheduler appears at the top of the list.

Limitations

• Video duration: you can import videos up to 300 seconds long. Genuin rejects longer videos during import.
• One scheduler per URL: each brand can have one scheduler per URL. The duplicate scheduler check rejects a URL that already has one.
• Concurrent imports: you can run up to 3 imports at the same time.
• Validation: the URL must pass all three validation stages, required fields must be mapped, and a community and group are mandatory.
• Schema changes: a change to your feed's schema might break its scheduled imports. After you change your API, review the scheduler's field mapping.

See also

• Schedule recurring imports from an RSS or MRSS feed
• Import videos from an RSS or MRSS feed
• Scheduler configuration
• Sync videos between social media and Genuin
• Post a video to a group